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TROUBLE SHOOTER 


TROUBLE 


Bryan Davies gets a B in his bonnet. The editor says: “Oh, K.” 


ardly had the August Trouble 

shooter gone off to the maga 

zine than my comments about 

not using Archive started to 

seemless funny. The time had 
come to try to do something with a set of 
| accounting routines written in the Archive 
language, years ago, andit was soon clear 
that this was no easy task. Not to put too 
fine a point on it, | gave up, but only after 
several days of struggle. Maybe the origi- 
nal programmer wanted to keep the code 
obscure in order to protect his commercial 
interest, but that probably wasn't the main 
reason for my difficulty in following the 
thread. 

Weall have our trouble trying to think 
straight. We usually find it easier to get 
stuck straight in to the job, as we see first 
see it. Only later do we realise the agonies 
created by nothavinga plan or flow diagram. 
You can get away with unstructured pro- 
gramming when the program to be written 
is short and simple, but this program ran to 
over 70 pages of procedures. It wasn't 
really the program as such that caused the 
| problems; it took so long sorting out rela- 
tively minor errors and making the screen 
presentation acceptable that there was 
little time left to consider the operation. 

That may sound like a lack of plan- 
ning, but maybe it was more due to my 
assuming the program worked properly, 
rather than being my normal sceptical self. 
The outcome was a partially-working pro- 
gram, better in its user interface but still 
with some gaping holes in it. Maybe some 
of them will be sorted out later, but | had to 
say that the contrast between working with 
Archive and with the program | use often on 
AN Other machine was painful. 

The area which highlights the big 
weakness of Archive is that of testing 
Procedures and Screens. The language 
itself is good, but what a performance to 
modify and check what you write! Bear in 
mind that the program had several hundred 
small Procedures, combined into a couple 
of dozen groups. To modify anything in a 
group, you have to run Archdev (not Ar- 
chive, since this program was to run under 
the run-time version, Archrim), Load Ob- 
ject “flp1_procname”, scan through maybe 
a dozen individual Procedures, find the 
area that seems to need changing, make 


the change, Save Object “flp1_procname”, 
then Run Object “flp1_boot” to run the 
whole program, select the option concerned 
and see if it now works as desired, then go 
back through the whole process when it 
becomes clear something is still wrong. 
Should you screw it so badly that 
there is no way out - easy enough with 
routines where the user has to press a key 
- you may have to reset, possibly making a 
hash of connected data files and having to 
start again from scratch. After doing this a 
few dozen times, with a few dozen groups, 
each with a dozen or so individual Proce- 
dures, one can get a bit browned off. In 
some ways, even so, this is easier than 
dealing with Screens, where the routine is 
similar but harder to get to grips with. 
From the user’s standpoint, such a 
program will probably work better in 
SuperBasic and compiled with DP’s Turbo. 
The programmer will have security, too, as 
few users will be able to modify compiled 
code. However, you may be like me and 
feel able to write simple Archive lines but 
uncomfortable writing in SuperBasic. If 
that’s the case, try observing a few “rules”: 


Draft a plan of what you have to 
achieve, and the routes to be taken to get 
to the various points on the way. 

Create Procedure names that have 
as much meaning as possible - don’t call a 
Procedure A2, for instance, when it is 
concerned with a listing name. Try some- 
thing like LISTNAME_PRO. 

Do likewise with Variables - don’t 
use AQDV$ when ORDERNOS is more to 
the point. 

If you have sufficient ram to hold one 
large Procedure group, create just the one, 
and do away with duplication of common 
Procedures (eg for printing to the screen) 
in several groups. 

Load both Procedures and data to 
ramdisk(s), to improve operating speed. 
You can use SuperBasic to WCOPY pro- 
gram and data files to ram then start the 
program from ram. 

Write backup Procedures to copy 
the data file(s) to two floppy disks atintervals 
during working sessions - don’t wait to the 
end of a session to do backups, as the end 
may come before you intend it to. 

Use Archdev and Archrim, rather 


than Archive, because Archrim takes less 
space and runs faster. 

Archive on the QL will never be a fast 
operator. Try to get the best out of it by 
using the run-time version, providing it with 
as much ram as possible, and using the 
fastest QL you can get - both those point 
imply a Gold Card, of course. 


Checking spelling 


Perhaps some of my past comments 
on this operation gave a false impression 
of my feelings on dictionary size. My in- 
tention was definitely not to imply that 
biggest is best where word-list (“dictionary”) 
files are concerned - far from it. Ken Whyld 
(Open Channel, July 1992) points to one 
dilemma, and the editor gave one solution 
for it. The larger the word list, the more 
“words’ it is likely to contain that can mask 
incorrect spelling in documents. This is 
inevitable, as computer word lists are gen- 
erated from dictionaries which contain 
common abbreviations, such as the one 
Whyld cites. “dod” - if written in capitals - 
could be short for Department Of Defense 
(US spelling, of course). 

(My Chambers gives “dod” as ‘a 
slight fit of if-humour; the sulks (often pl.) 
(Scots.); as “to poll, pollard or clip (obs or 
dial)”; and “a minced form of God, in Oaths” 
- all reasonable reactions to a spelichecker 
that won't pick up a mistyped “did” - Editor.) 

It is unfortunate that many 
spellcheckers are deficient in their ability to 
handle capital letters, and this is a func- 
tional reason for the problem he is worried 
about; if the checking mechanism were 
improved, it would not matter so much that 
such words are in large lists. As both Per- 
fectionand text87come with large and small 
word lists, the user can decide what his/her 
main problem is - spelling errors or typos - 
and choose the size accordingly. 

The weakness in handling capital 
letters regularly annoys me, but it may not 
trouble many users. Itis primarily technical. 
For example, how do you write the abbre- 
viations for megabytes, kilobytes and 
megahertz? The latter is perhaps the 
easiest; there are international standards 
for electrical terms, accepted by engineers 
and scientists. Units of measure named 
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after whoever created them are often allo- 
cated a capital, such as Hz for Hertz. 
Where the same initial-letter could be used 
for several different quantities, the larger - 
such as M for mega (millions) might have 
the capital and the smaller (Greek mu [] for 
millions) a lower-case or related symbol. A 
lower-case m denotes milli- (thousandths) 
as in millimetre. (“Thousands”, on the other 
hand, uses a lower-case k, from the Greek 
“kilo” (km for kilometre.) 

Where computers are concerned, 
the computer press doesn't seem too well 
versed in the efforts made by the engi- 
neering and scientific communities. You 
can see kilobytes shown as kb, KB, Kb or 
kB, and megabytes as mb, MB, Mb or 
MG. The latter is surprising; presumably 
the “G" comes from mega, but the usage 
has to be wrong, surely? Another reason 
for capitals is the German manner of 
writing the full words, such as Kilohertz. 
As “byte” is not a name, a small letter 
seems appropriate, but I’mloath to change 
from my own normal usage of “B”. To 
confuse the issue further, computer 
people have chosen - not without reason 
- to use “k” for a value which is not 1,000. 
Akilobyte is 1,024 bytes, anda megabyte 
is 1,024 by 1,024 bytes (2 to the power of 
20). 

My own electro-technical German- 
English dictionary appears to accept both 
capitals and small letters for the qualifiers, 
so maybe there is not as yet a “right” way 
of putting them. 

(The Editor comments: I’m puz- 
zled by some of this. The computing 
and engineering journals | have worked 
with over the years have been careful 
with standard symbols. Engineers 
(electronics and computing) and pro- 
fessional journalists - in the UK and 
USA, at any rate - have a separate 
standard symbol for binary thousand 
(1,024): a capital K. The same symbol 
also denotes degrees Kelvin, a 
measure of temperature, which is not 
easily confused with binary thousands. 

The lack of an accepted standard for 
“bits” and “bytes” is a pest. We use MB for 
megabytes, amd Mbits or Mb for megabits. 
I've never seen MG for megabytes. German 
capitalises many common nouns, but that 
shouldn't affect the use of symbolic letters. 
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Many compilers of technical stand- 
ards think that engineers have an attitude 
too narrowly focussed on their own local 
practices or areas of expertise. Many engi- 
neers think that writers of technical stand- 
ards are wazzocks; | agree with both of 
them, but as most engineers and technical 
writers | personally work with handle ana- 
logue, digital, hardware and software de- 
velopment simultaneously, | pay close 
attention to their usages.) 


... And now, back to 


Returning to the spellchecking 
function, to cope with abbreviations, the 
checker needs to be able to recognise 
capital letters, which may be at the start or 
end of words, or in the middle. Some 
checkers can recognise that, for instance, 
“Germany” is correct and “germany” is 
incorrect, but that’s about the limit, and this 
is where the large word list can let you 
down. 

In practice, 10-20,000 words is 
enough, but a large separate list may need 
to be added if the user has a good collec- 
tion of abbreviations and proper nouns 
(suchas “Joseph”, “Glasgow”, “Safeways”). 
My own experience has been that no more 
than about 10,000 words are added to a 
bought word list, and the same number are 
usually added to any new list - regardless 
of size - simply because they are almost all 
abbreviations or proper nouns which are 
rarely included in commercial products. 

The larger of the various Perfection 
word lists are an exception, as they have 
had many such words added to them and 
will generally not be caught out by common 
words such as “Sinclair” or “QL”! There is 
some merit, then, in having bigger lists, 
and this is especially true if you work ina 
trade which has its own vocabulary, or you 
make use of less common words, for 
whatever purpose. 

Don’t assume, though, that all 
strange words in your own particular field 
will be included in a list which has over 
100,000 words. In practice, you can find 
many quite normal words missing from 
150,000-wordlists, and even 300,000-plus 
lists will not contain all words used in 
specialist areas. 


TROUBLE SHOOTER 


SHOOTER 


Cross-eyed OCR 


OCR (optical character recognition) 
has been a Holy Grail in the electronics 
development world for many years. 
Younger computer freaks may not realise 
how long such facilities take to develop. In 
my own experience, OCR ranks with blind 
landing as something which has taken a 
surprisingly long time to come to com- 
mercial fruition. If one ignores pioneer ex- 
periments, blind landing systems devel- 
opment dates from the early 1940s. We 
were working very seriously with two 
commercial system philosophies in the UK 
in the early 1960s, but such systems have 
reached the level of common, reliable use 
only in the past few years. Attempts at 
OCR presumably date back at least as far; 
certainly, | worked on production reading 
machines at the end of the 1960s. 

This doesn’t alter the fact that read- 
ing technology still has far to go, and you 
need to ignore much of the verbiage on the 
subject. There are several OCR compo- 
nents on sale, and a very few capable 
software products to go with them, but they 
all suffer from basically the same constraints 
as before. The printed or written text needs 
to be of good quality and consistent form. 
What brought this to mind was the editor’s 
explanation of the gremlins that got into an 
article in the May/June issue. 

It may be fairly easy to scan text into a 
computer in the form of one image, but that’s 
a long way from translating that image into 
individual characters and feeding them in the 
correct formatinto a word-processing program. 
Performance figures of over 90% accuracy 
are commonly quoted for quite cheap OCR 
readers, and that sounds good at first reading. 
When you calculate how many errors that 
means per thousand: words of text, it looks 
much less good. An article of the size of this 
one would have around 2,000 individual char- 
acters wrong at a reading accuracy of 90%. In 
the worst case, that would mean nearly 70% of 
the words having an error. A good typist can 
manage over 100 words per minute and will 
have been graded to an accuracy of 98%. At 
least, with OCR, errors may do no more than 
cause laughter, whereas even a small error 
when an airliner is landing in zero visibility can 
mean disaster. 


Disks again 


R Snow reported his problem with 
5.25-inch floppy disks, in the May-June 
issue, and his conclusion - that the trouble 
was with the drive not the disks - seems the 
correct one. Being very much of the “watch 
the pennies” inclination myself, | never 
consign a floppy to the bin without a big 
fight, but one has now defeated me - the 
first in more than six years (and close to 
1,000 disks). It was an old Philips-brand 
5,.25-inch 360 KB one that has held the 
Turbo-DOS operating system in its youth. 
Out of curiosity, and for the benefit of 
clients who know little of the innards of 
disks, | opened it up and was mildly sur- 
prised to see what seems like a paper-thin 
piece of dishcloth between each side of the 

| casing and the magnetic platter. 

The platter itself is very flexible and 
it is not surprising to hear of disks being 
doubled over and still coming up smiling 
when used afterwards - but don’t try it. An 
example of this occurred about the same 
time, when a well-known (PC) software 
company sent me an upgrade to its oper- 
ating system, in a flimsy A4 envelope, the 
§.25-inch disks arriving with marked kinks 
in them but giving only a slight hint of 
trouble when used. In the case of my sole 
dud disk, the reason was clearly evident - 
there was scoring on one side, where the 
read/write head had apparently come into 
more-forcible contact than usual with the 
magnetic surface. 

Given reasonable care, floppies re- 
ally shouldn't give you trouble, even over 
periods of five years or more. During a 
recent re-organisation, some of my old 3.5 
inch disks were reformatted, and files 
transferred between them, with no sign of 
problem; the files on them dated back as 
far as 1985 and had not been touched in 
the intervening years, other than being 
used read-only for tests, now and then. 
Surprisingly, one disk that had (not long 
ago) failed to format properly in one PC but 
had formatted correctly in the QL proved 
itself quite happy to format without error or 
murmur in another PC. Perhaps for the 
same reason, three or four commercial 
program disks which had behaved without 
problem in one computer gave reading 
errors in another. 


Times change 


What does seem to be true is that the 
quality of batches of disks varies appreci- 
ably, and having a known brand name on 
the casing is no guarantee of reliability. 
Some time ago, you might have been safe 
buying from the same supplier at intervals 
of months, even years, because your 
supplier might well have been buying from 
the same source all the time. Thisis unlikely 
to be the case now. For afew years, supply 
was greater than demand and dealers took 


to buying job-lots from wherever they could, 
to keep their own prices competitive. 

Obviously, quality tends to vary when 
the source is not constant. Recently, there 
have been regular reports of a general 
shortage of 3.5-inch disks, leading to some 
increase in prices, but this shouldn't be 
expected to improve the quality situation. 
The reason generally given for the short- 
age is that two software suppliers - IBM 
and Microsoft - have been selling so many 
copies of their operating system (OS/2) 
and front-end (Windows) programs, re- 
spectively, that they have taken a large 
slice of the disk supply. OS/2 version 2 
comes on 21 high-density disks, no less! 
(Compare that with the economical two 
rom chips in which Qdos sits). The short- 
age doesn’t seem to extend to DD disks, 
fortunately. 

Those happy users having extra- 
high density (ED) drives may be able to get 
the disks at better prices before long, as 
the first non-IBM PC systems equipped 
with 2.88 MB drives have appeared in 
adverts. However, the (mainly-PC) com- 
puter magazine that claims to be “the best” 
still stated in a recent issue that ED disks 
cost £10 each - maybe PC users should 
buy from Miracle Systems. As Miracle 
provide 10 disks in their price of £175 
(including VAT) for dual ED drives, that 
would seem to suggest they are almost 
giving the drives away. 

One incidental, but significant, 
advantage of using ED drives is the 
space saved in storing disks. An ED 
disk holds 3.2 MB of files, which is 
more than four times what a DD disk 
holds; roughly, it takes only two ED 
disks to hold the same as nine DD 
ones. If you are short of workspace, 
this saving can make computing life 
much easier. One small box of ten ED 
disks from Miracle might well suffice 
to hold everything you need. 


Demo disks 


The new editor of Quanta, John 
Vanags, made what sounds like a good 
suggestion in his July issue. He made the 
obvious point that users are not keen to 
part with their money without knowing 
something about the goods first. Not all 
users can get to Quanta meetings and see 
software demonstrated by the suppliers. 
An alternative way of learning something 
about a program would be through a 
demonstration version of the program. 
Supplying demo versions of WP and other 
types of program has been common 
practice in the PC world for years, and it 
must certainly have influenced the buying 
decisions of a fair number of users. Ademo 
version is essentially a cut-down version of 
the program, capable of showing major 
features but not usable for serious work by 
the recipient. 

For example, you might be able to 
create documents, but not print them. One 


very good demo disk | received allowed 
you to use many of the program features 
and even to print files which were supplied 
(but not ones you created). Other demos 
merely display program features without 
allowing the viewer to get involved, but this 
approach tends to make you go glassy- 
eyed quite quickly and seems much less 
effective as a selling tool. 

By-and-large, the demo disks | have 
had were free; the only one | recollect 
paying for was from Microsoft (no surprise) 
and cost about £10. QL suppliers aren't in | 
the same money league as PC ones, and 
demo disks would almost certainly have to 
be paid for, but the payment could be made 
refundable if the full version of the program 
concerned were purchased subsequently. 
Demo disks just might reduce the amount 
of piracy - itis very easy to ask a friend for 
a copy of a program, “to see what it is like”. 
Any comments, suppliers? 


Text87 manual 


In response to various requests, 
Software87 have revised the instructions 
for the Plus-4 version of text87. There is 
more information on subjects which may 
have caused users problems previously, 
such as the Room command. A consider- 
able number of changes have been made 
to the program during the transition from 
issue 1 through 2 to the current 3, and 
much of the added material concerns these 
changes. A welcome addition is a Glossary 
and Index. The on-screen Help information 
also has been extended. The program is, 
overall, quite a bit easier to use now than 
when it first came out; as indicated in last 
month’s review, it is a very much more 
capable program than version 3 was and 
should find favour with both existing T87 
users and late converts from Quill. 


Name change? 


Bill Richardson of EEC is now trad- 
ing under his own name as well,| according 
to his advert - from the same address as 
previously. Amongst otheritems ofinterest, 
he is offering hard disk drives, in either kit 
form or ready-boxed, and interfaces to 
allow various combinations of devices to 
be connected through the QL 64-way ex- 
pansion port. He still has stock of QLs, and 
of both DD and HD 3.5-inch disk drives. 
The QL World readers’ offer of new QLs at 
£69.95 is going like hot cakes. 


Readers’ letters 


There has been something of a hia- 
tus, with letters presumably going to the old 
addresses and taking a long time to catch 
up with us. Please check the new address 
for correspondence, at the front of the 
magazine. It is different from the one in the 
May-June issue. 


PERFECTION SPECIAL EDITION 
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m=] POWER 

PERFECTION SPECIAL EDITION has 253 (two hundred and fifty three) direct/menu commands 
{not counting options in sub-menus), plus 32 special characters (like Bold on) that can be 
inserted ‘directly’ plus intelligent (and now excellently documented) macros. Comparisons with 
other word processors on the subject of power are hence quite unnecessary. 


Mi EASE OF USE 

Independent reports, customer feedback and published reviews (of its less 
able but still excellent predecessor, PERFECTION) leave one in no doubt as 
to which word processor is friendliest - PERFECTION SPECIAL EDITION, 
with its intuitive, silky handling. Uniquely, it has two operating modes, with 
both menus (visible or invisible — they even look like Quill's) and direct 
commands (for when you familiarise yourself with the system). Uniquely, 
both modes are ‘re-entrant’ (so you can use any menu option or direct 
command while you are in the middle of performing another option or 
command — block handling, etc, becomes a dream). Uniquely, PERFECTION 
SE has fully automatic memory management, grabbing and releasing RAM 
instantly as your document grows ot shrinks — programs without this don't 
take full advantage of the multi-tasking abilities of the QL! Uniquely, 
PERFECTION SE leaves you in the driving seat, not juggling things around 
‘underfoot’ while you are typing. Uniquely, PERFECTION SE allows up to 
nine different documents to be handled simultaneously from one copy of the 
program — each with totally independent margin, tab, justification, control 
panel, etc, settings. Uniquely, each document can itself have up to six environment settings, 
each settable or recallable instantly with a single keypress combination. Each document can 
have any number (up to 500,000 on GOLD CARD) of candidate blocks! Each document can 
have two independent windows (of any depth, of any (but same) width across) ‘on to’ it, even 
with overlapping text — that allows you to edit in one place while viewing another, to compare 
‘before editing’ with ‘after editing’ (you can arrange to have one window remain ‘frozen’ in time}, 
etc. Uniquely, we realise how much faster it is to type in something like CTRL/SHIFT/F5 than 
(say) F3 F3 R — both involve three keys, but as the former doesn't require the keys to be 
pressed in just one specific order, or to be released in any order at all (together will do), it is in 
practice twice as fast as the latter, where no key may be pressed until its predecessor is 
released. PERFECTION SE takes advantage of all this — it is the little things that count! 
Uniquely, by providing eight user-definable strips, PERFECTION SE allows you to cope with 
printers of the future, not just the printers that now exist — you can attach the strips to any 
printer features, Uniquely, PERFECTION SE's status lines give full information on all relevant 
global settings. And the manual has an index. Also, it has all the important bits at the front. 


ma WYSIWYG? 

By the latest definition of this term, neither is PERFECTION SE fully WYSIWYG, nor are other 
QL word processors, WYSIWYG means what you see on screen is exactly what you get on 
paper. Exactly — down to every wiggle in every character in every font. 


To get true WYSIWYG, use PERFECTION SE's fully automatic link (supplied as part of 
PERFECTION SE} to PROFESSIONAL PUBLISHER, where you will get 100% WYSIWYG. 
100%? Yes, 100%. With this combination, adjust the horizontal and vertical magnification on 
your monitor (ie calibrate it once and for all so screen circles correspond to same-diameter 
printed circles — poor monitors may distort a little bit at the edges). Now you can place your 
printed output from PERFECTION via PUBLISHER over your monitor screen, and get a match 
that is more perfect than is your eyesight. Now that is WYSIWYG, 


ma SUPERB PRINT QUALITY & FLEXIBILITY 
Uniquely, using the aforementioned automatic link, you can output PERFECTION SE 
documents using over a thousand fonts (a huge variety of styles and sizes, supplied on the 
PUBLISHER and TOOLBOX disks) on virtually any printer — from the humblest Epson RX80, 
Brother M1009 or Star LC10 (which are all single font machines when used with most word 
processors) to top-end lasers. Yas are wat limited ta the fonts Cuilt inta the 
forénter// All PERFECTION SE bold/underlined/ italics/SUPET/.))), etc, settings are 
preserved, Proportional spacing and micro-justification are automatic, even when you 
mix fonts of differing widths and heights (even on the same line), vary line spacings, 
etc, Uniquely, you are not trapped with one type of micro-justification (ie adding all the space 
between words, and using the predefined widths of characters as their separation) — with our 
system, you can vary (in 5% steps) the proportion of micro-spaces added between words to 
that added between characters (the latter in proportion to their individual widths), Settings 
around 65%-35% — not the 100%-0% forced upon you by some other word processors — 
seem to give the most pleasing results. Uniquely, you are not limited to mere rectangular 
columns plus headers/footers — that's all the rest can do — you can output in any sequence to 
any number of frames (text flowing from one to the next}, each of any shape — irregular 
polygons of up to 66 sides, circles, multi-column or part-column boxes (hundreds of types of 
borders, thousands of textures), doughnuts, wrap-around shapes, even re-entrant ones 


the best! 


Professional Publisher is 


publisher for the OL even cones close. 


(‘join-the-dots' type borders, even with intersecting edges) — all with micro-justification and 
proportional spacing! Look at the example on this page. Of course, if super fancy output or 
special effects are not of the essence, PERFECTION SE's direct printer output is more than 
capable of meeting your needs. 


mg THE FASTEST 

For benchmarking, we've used an unimpeachable file — not one created 
specially — a public domain version of the first book of The King James 
Bible, all fifty chapters of the book of Genesis. This came to one hundred 
:} and forty pages, well over forty two thousand words excluding 
headers and footers, well over two hundred and twelve thousand 
characters excluding justification ones and one thousand five 
hundred and thirty three indexed verses!! We didn't use a smaller file 
(as used to benchmark other programs) as PERFECTION SE's timings for 
most operations then become impossible to stopwatch (too fast!}. The 
hardware used for all timings was GOLD CARD: speeds would be further 
improved by over three times using the ST/OL 030. Of course, 
LIGHTNING SE was used. File operations were to ramdisk: normal slave 
blocks would give identical times. All settings on everything were for 
maximum speed, except where indicated to the contrary — we have the sense 
not to force full speed upon you in operations like scrolling and global 
Search & Replace. PERFECTION SE's speed for these is switchable 
(at run-time and when configuring), as too great a speed may cause 
overshoot (with scrolling) or fatal alteration (if there is human error inputting the target or 
replace strings). Here are the benchmarks for this huge file: 


Ha other desktop 


Load 140 pages: 0.6 seconds {yes 0.6, not 6!) v% Import 140 pages: 0.6 seconds (yes 0.6, not 
6!) v% Save 140 pages: 0.5 seconds (yes 0.5, not 5!) x Export 140 pages: 0.5 seconds (yes 
0.5, not 5!) v% Case-sensitive search from top for word at bottom: 0.4 seconds (yes 0.4, not 4!) | 
vx The same, but case case- insensitive: 0.5 seconds (yes 0.5, not 5!) v% Case-sensitive search 
backwards from bottom for word at top: 0.4 seconds (yes 0.4, not 4!) vw The same, but case- 
insensitive: 0.5 seconds (yes 0.5, not 5!) vx Automatic Search & Replace, in Fast (No Query) 
mode, of last 600 occurrences; 7,4 seconds (same length replace string); 7.7 seconds (shorter 
replace string); 10.5 seconds (longer replace string — longer time as we deliberately chose a | 
high density of replaces to handicap PERFECTION SE into auto-managing memory — without 
causing any heap fragmentation, but still with only a 0.005 second overhead per replace!) 
vx Automatic Search & Replace in Slow (‘Querying’) mode: arbitrarily slow, typically 30 limes 
slower — because we deliberately allow for human response time (in case you want to abort) 
before proceeding from one replace to the next — booby prize to anyone for benchmarking us on 
this setting! x Scrolling 100 lines of text, up or down, by full-width screen page: 1.5 seconds 
x Scrolling 100 lines of text on full-width screen, line by line, in slow (full) mode: 5.7 seconds 
(down)/5.8 seconds (up) vx As above, but in medium speed mode: 4 seconds vx The same, but 
in fast mode and default settings: 13.5 seconds to scroll through the whole massive document, 
averaging 0.23 seconds per 100 pages (!) ~ and this could be made up to ten times faster by 
reconfiguring PERFECTION SE ve Reformatting paragraphs, changing margins, justification, 
etc, of existing text: ¢5 times faster than predecessor vx Inserting (or undoing) emphasised, 
underlined, italics, superscript, subscript, 8 strips, 6 environment settings; Instant | 
(ie. immeasurable) vx Navigation to line or page or to top or bottom or to 8 markers or to 
highlights/blocks: Instant vx Setting new margins, justification, etc: Instant vx Deleting block of 
100 pages: 0.3 (yes, 0.3 not 3!) seconds vx Copying/moving block of 100 pages {not just 10!), 
downwards or upwards: 3.4 seconds (yes, including all the time for automatic memory 
management and anti-fragmentation — other programs are light-years behind) v Spellcheck as 
you type: Ten times faster than anyone can.possibly type vx Spellcheck all 140 pages in the 
document using the 350,000 word Mega Dictionary: 3.9 seconds (20 ‘errors' — like ‘pluckt’!) 
vr And using our tiny dictionary (well, tiny by our standards - large by comparison with most 
others): 5.1 seconds (566 ‘errors’) a Time taken to creale user dictionary from the results of the 
second spelicheck {566 errors): 0.8 seconds to extract all ‘errors’ from document and clean 
document; 1.9 seconds to create a full user dictionary thetefrom and also a sorted, duplicate- 
tree wordlist file (for browsing) 2 Spellcheck file (ASCII or native}: Even faster. x Print first 10 
pages to file: 3.5 seconds. vx Change every occurrence of God to @e@! in bold underlined 
italics, strip 2 - 9.5 seonds! 


For prices, see the coupon page of our ad. For more info, read our detailed ads in early 1991 for 
PERFECTION, plus the extra features of the SE (well, about half of them) listed in the June- 
August 1992 issues. You can upgrade from the standard PERFECTION (or PLUS) to the 
SPECIAL EDITIONs for the difference in current price, plus £10 (no manuals or dictionary disks 
to be returned — we'll send manual supplement). No discount to users of other word processors 


QUICKLASER — The definitive output tool from PRO PUBLISHER to HP LaserJet Il (or 
compatible) printers. Printed output quality subjectively exceeds that from any other QL product. 
TRANSFER UTILITY SPECIAL EDITION — Does everything — 16 case change options, 14 
types of sorting (multiple sorts possible}, auto string translations, etc. 

LIGHTNING SPECIAL EDITION GOLD CARD VERSION — See June-Aug 1992 OLW tor 
details: optimal speed from GOLD CARD, ST/QL, THOR XVI. Free upgrade from the ROM SE 
version (return ROM + disk} if you are ordering something else at same time: if not, £10 charge. 


C68 C 
Compiler 
Source 


When V3.00 of the C68 C 
Compiler was released, in 
June 1992, only the runtime 
The 
Compiler has now been up- 


disks were available. 
graded again, and the source 
code is now available, 

The Compiler is now ver- 
sion 3.01; some bugs de- 
tected in 3.00 were quickly 
pul right by Dave Walker. 
The source code has been 
compressed onto two 3.5 
inch 720K Disk | 
contains a boot program 
which will load the Packer/ 
Un-Packer, a program called 


disks. 


RamCopier for users with 
single disk drives and two 
of the compressed source 
code files. Disk 2 contains 
the remaining 
source code files. 

C68 V3.01 Runtimes (3 
disks) £3 (pre-copied disks), 
£1.50 (user sup plies disks) 
postage & packing 50p 
(UK), C68 V3.01 Source 
Code (2 disks) £2 (pre-cop- 
ied disks), £1 (user supplies 
disks) postage & packing 
50p (UK). C68 V3.01 Full 
Issue (5 Disks) £5 (pre- 
copied disks), £2.50 (user 
supplies disks) postage & 
packing 50p (UK). 

Orders and enquiries to 
QubbeSoft P/D, 38 
Brunwin Road, Rayne, 
Brain tree, Essex CM? 
SBU. Tel. 0376 347852. 


compressed 
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SCENE! 


Dutch Translation 
Help Wanted! 


Qubbesoft’s Ron Dunnett has a challenge - he wants a QL user to help translate Dutch software for the 
public good. “I have kindly been given loads of very good Public Domain software for the QL by the Dutch 
QL User's group,” he writes. “The trouble is that most of it has Dutch text or _doc files, so Tcan’t put it out 
to English users, as they won't have a clue what's going on (unless they can read Dutch). Some of the 
programs are very good, and deserve a much wider audience.” 

Plus, says Ron, success might stimulate the authors to write more software in the future. He also has 
German software that has its text files which need to be translated into English from German. A previous offer 
of help from a user in Switzerland fell through when Ron sent him the files and heard nothing further! 

“Pm getting more and more software from Europe, for my public domain library,” says Ron, “And very 
little from UK users. I find this very odd.” 

Contact QubbeSoft P/D at 38 Brunwin Road, Rayne, Braintree, Essex CM7 SBU. Tel. 0376 347852. 


The Zike, Sir Clive Sinclair's latest invention, is reported to be running behind its original production 
schedule. 

The electrically-assisted bike, which Sir Clive hopes will recoup some of the losses sustained by his 
previous vehicular venture - the C5 electric car, unkindly compared by some to an electric bath-chair - was 
promised for the end of May. Customers who sent cheques for the £499 bike have been sent letters of apology, 
and will be given a discount when their machines are despatched. 

The Zike is now expected to be in full production in August. With a top speed of 15 mph, licence-free road 
use by anyone over 14, and a non-polluting power source keeping it ‘green’, the Zike may be heading for | 
success. The failure of the CS was blamed by many on unreliable batteries - slow speeds, users say, are no 
problem - but no speed ts. Battery technology has advanced in the intervening years. 

Sir Clive blamed the delay to the Zike on problems with a production tool. The signs are, though, that Sir 
Clive’s fans don’t mind waiting a little longer. “I'm sure the Zike will get here,” said one. “I just hope he isn’t 
going to try and invent the Wheel first.” 


Dried to Distraction 


is anything to go by) and then properly proofread. 

Unfortunately, under the pressure on our first 
Production Day, the pre-proof version of the file was 
imported onto the page. 

All QL World features are now read by the editor 
before they go onto the production computer. (With 
one or two small but notable exceptions which are 
sull giving us gyp in the holiday season.) 

Meanwhile, we are still trying to work out what a 
hue memory is, how you roup a file, and why anyone 
should want to dry a disk. Suggestions to Open 
Channel, please. 


By the way, thank you to everyone who wrote to 
console us for the troubles we lived through earlier this 
year and saying how pleased you were lo see us back. 
OL World felt a bit like a ghostly swan during that time 
- nothing showing aboye the water, frantic paddling 
underneath! 

Apologies also to those who were baffled (or en- 
tertained) by some strange expressions in Mike Lloyd's 
review of the Gold Card in the May/June issue. For that 
issue, we read nearly all the copy through an optical 
scanner. It was then swept with a spelling checker 
(note well - a very bad combination, if our experience 
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POOLS PROGRAM 


WINNING 
THE POOLS! 


Businessman Stan Caton has pooled his QL re- 
sources in the hope ofa win. David Drysdale reports. 


hen North Manchester busi 
nessman Stan Canton, now 
semi-retired, bought a QL in 
the machine's early days, it 
was not a toy he was seeking 
buta professional machine capable of some 
very hard work. 
The work began the day the QL 
arrived, but it was Stan himself who had to 
do itas he laboured to program the machine 
with the help of the manual. His wife Maggie 
quickly became a computer widow as he 
would sit at the QL, on his days off, from 
5am until late evening and would have to 
be physically shaken out of his concen- 
tration to come away for a meal. 

There was one bonus for Maggie, 
though. Stan had always been an early 
riser who would waken the family by walking 
around at 5am. When the QL came he 
would go quietly to the keyboard as soon 
as he awoke and Maggie would get some 
peace. 


QL housing 


From the start the QL and its pe- 
ripherals took up too much workspace, so 
Stan designed a timber unit to keep it all 
together on the table top. It was probably 
one of the very first ‘workstations’ ever 
built, but Stan named it the Compu-cabinet 
and offered it for sale in QL User at £45. 
Only four people sent for itand so, naturally, 
Stan stopped makingit. He still uses one of 
the cabinets which he has mounted on a 
foldable metal framed trolley so that it can 
be transported to demonstrations and ex- 
hibitions. 

Stan's next venture on the QL was 
the design of a business cash flow chart 
which he developed with the aid of Maggie 
who was a professional bookkeeper. Again 
he advertised it with QL User, and this time 
he was more successful. The program had 
been intended in the first place as an aid to 
Stan’s own businesses and much im- 
pressed his bank manager. The QL User 
sales were a welcome spinoff. 

Stan's varied business ventures in- 
cluded professional photography, kitchen 
designing and running a launderette, but 
whatever he was doing he found the QL 
was at hand to help. When selling kitchens, 
for example, he designed a program that 


would not only assist in designing the 
kitchen layout but cost up the job as it went 
along. 

This program so impressed a busi- 
ness colleague who was into bedroom 
furniture manufacture that he sought Stan’s 
help in developing a way of computerising 
his own price lists. 


Adaptable Abacus 


In his programming work Stan finds 
that Digital Precision’s Editor, along with 
the Turbocompiler, is an absolute must. Of 
the supplied software he is mostimpressed 
by Abacus, which he finds is amazingly 
adaptable and can organise business and 
accounts applications of every kind. He is 
also quite fond of Quilf which he feels has 
been given a new lease of life with the Gold 
Card. He now uses front end program 
Qpac2 which, when eventually mastered, 
revolutioned his program and file handling. 
A PC-style keyboard completes his 
equipment. 

An important development for Stan 
has been the setting up of the Manchester 
Quanta group QUM. Prior to this everything 
he accomplished on the QL had been done 
the hard way by having to work through his 
problems alone and with only the manuals 
to help him. 

The group is now involved in im- 
porting public domain software from PCs 
into the QL and Stan has been quite busy 
assisting Sohail Bhatti of QLaw and the 
other members with this work. Again, Editor 
and Qpac2 have come to the rescue and 
Stan has written a program to automate 
processing of a full disk of files. 


Washed out 


All this QL activity is having a much 
needed therapeutic effect on Stan who 
some time ago had a traumatic time with 
the collapse of one of his businesses. The 
business, a very popular launderette on a 
council housing estate had been so busy 
that Stan decided to re-equip it with the 
latest and best machinery. 

This was no sooner done when the 
council handed the estate over to private 
developers who modernised the homes 


and installed washing machines in all of 
them! Not even the best of Stan’s sophis- 
ticated QL cash flow programs could save 
him from the financial meltdown that fol- 
lowed. 

Stan, however, seemed quite un- 
perturbed by it all as he led me from his 
luxurious lounge overlooking a small forest 
of trees to his QL den to see his latest 
brainchild - a Football Pools odds-analysing 
program. There was nothing silly or mys- 
tical about it, he assured me, as it was 
based on mathematical analysis of the 
methods of the only real pools experts, the 
Bookies, with the sole aim of increasing the 
winning odds. 


Fixed odds 


It is quite a sophisticated program 
and its development so far has convinced 
Stan that while it has a huge potential for 
increasing a punter’s likelihood of winning 
the Treble Chance it is a must for enthu- 
siasts who favour Fixed Odds coupons. 
They, he assured me, are likely to have 
even better results and should see a steady 
profit from their pools investments. He has 
no intention of setting up as a pools tipster, 
he said, nor was he inviting the public to 
join him in some gigantic permutation. His 
aim was to develop, refine and degbug the 
program which would be offered for sale in 
a QL World advertisement. The punters 
would then be given a powerful tool with 
which to develop their own forecasting 
skills. 

As Stan, Maggie and | sat down with 
a cup of coffee Stan reminded me that the 
program had really been intended for his 
own use and he had great hopes of landing 
a good win with it. It would also be on 
exclusive offer, atthe start, to owners of the 
QL. 

Just as there are people who have 
decided to stick with the QL because of | 
programs such as Perfection, there will be | 
others, | suppose, who will find that Stan’s 
new program will give them all the incen- 
tive they need to stay with the QL - the 
country’s “winning” computer. 


| —_ 


SOFTWARE FILE 


QTOP 


Del Allen tries out the most recent 
version of QTop for the QL and Thor. 


INFORMATION 
Program: QTop 
Publisher: Cowo, Munsterstrasse 4 
CH-6210 Sursee, Switzerland. 
Available from: Software87 

33 Savernake Road 

London NW3 2JU 

Price: £29 


Top is a front end for the QL. A 
front end usually consists of a 
series of menus from which you 
can select various options 
intended to make life easier.For 
example, selecting Files will 
result in the appearance of a sub-menu offering 
various things to do with files, such as View, 
Delete or Execute. 
When QTop is booted, it 
helpfully decides which of its files 


have. Mem-Info lists a few of the Qdos system 
variables. Clocks presents a choice of clock 
types, both analogue and digital. These are fun 
to look at the first time. A large analogue clock 
face can be shrunk and placed in a corner of the 
screen. Some people may prefer this to the 
digital displays - I did. But I normally use a 
clock provided by Toolkit H, 

Snap is a screen dump utility. [ have not 
tried this. QTop makes heavy use of the QJump 
Pointer Environment, which is a part of the 
package. The fact that the pointer environment 
is on the disk makes the package reasonable 
value for money. One could be forgiven for 
thinking that if one already has the pointer 
environment, there would be little point in 
purchasing QTop, but it has a few features that 


Pointer Environmentthen consider buying QTop. 

The manual is very well written 
considering its foreign origin - it is much better 
than many English manuals, though it lacks an 
index. As a bonus it includes details of the 
hotkey and TKI commands. It is extremely 
pleasant to have these all together under one 
cover. 

The rest of the QTop package should be 
regarded as a bonus. There are a lot of demos, 
intended, presumably, to impress with their 
speed. Sadly, visually, they are largely 
unimpressive, The sight of coloured blocks, for 
example, appearing and disappearing with 
extreme rapidity very quickly becomes boring 
and will not impress, say, Amiga owners, One 
or two, though, are quite pretty. The animation 

demos are a bit uninspiring, as one 
cannot do anything with them other 


to load, after checking the rom 
type and the amount of memory. 
The user merely has to insert the 
disk and press a key to inform the 
program which computer is in use i 
- QL, Thor, Amiga ete. After a 
short wait the Main menu appears. 
Here is an option to alter the default 
devices. For example, one can 
specily that, say, flp2 is to be used 
for data and fIpl for programs. 
| Another option calls up a jobs 
manager. 

Here one can do such things 
as listing all jobs. suspending a 
job, and so on. 

Yet another option is 
Myprogs. This will present you with 
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than watch. But they are not part of 
the Qtop system and should not be 
criticised too heavily! 


Different speeds 


The last item, Tindex, is 
different. It purports to show 
differences in speed in various 
operations between a standard QL 
and your system, and as such is 
interesting and informative, Itshows, 
for instance, that a QL with a 512K 
Expandaram is slightly faster than a 
128K QL, as one would expect. I was 
surprised to find, however, that disk 
handling was significantly slower, 
Upon querying this with the author, I 


a list of programs, provided that 
you have previously created the 
list. The method of creating a list is somewhat 
inconvenient, and the list itself is of doubtful 
use. The Tools option presents a few basic 
utilities such as hex to decimal conversion. 
Options allows changing baud rate among other 
things. 


Unforgettable 


Desk puts you into the Desk menu. Here 
you can remind yourself of which solid colours 
are available. If you have forgotten the colours 
in mode4, for example, you will see four bands 
of colour viz black, red, green and white. This 
is not something I forget very often, System- 
Info wall tell you things like which rom you 


make use of the pointer environment easier and 
this alone, I believe, makes QTop a reasonable 
buy. 

For instance, QTop somewhat cases 
button handling. A button is a little window 
with a program name in it. The button can be 
easily created and can be used to put a program 
to ‘sleep’, wake it up, and so on. 


Curate’s egg 


As IT inumated earlier, while there are 
some features that I could live without, QTop 
also has its good points - it’s a real curate’s egg 
in fact. If you do not already own the Extended 


was informed that Tindex should be 
run onan ‘empty’ machine, It did not 
and does not say this in the manual, To run 
Tindex onan ‘empty’ machine itis necessary to 
load up an extension file. [have copied Tindex 
and the extensions to a separate disk and have 
had a lot of fun trying different Lightning 
settings. But Tindex still tells me that disk 
handling with the Expandaram is slower than a 
standard QL with microdrives!. 

Tosum up: forget about the demos - they 
are free, anyway. The QTop system itself is 
worth having if you need a front end and do not 
already have the Extended Pointer Environment. 
A small proportion of its features are of limited 
usefulness, but the system as a whole may 
makea useful addition to your roster of working 
programs. 
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PEN WHANNEL 


Open Channel is where you have the opportunity 
to voice your opinions in Sinclair QL World. 
Whether you want to ask for help with a technical 
problem, provide somebody with the answer, or 


just sound off about something which bothers you, 


write to: 


Open Channel, Sinclair QL World, The Blue Barn, 
Tew Lane, Wootton, Woodstock Oxon. OX7 IHA 


Pirate Min! 


Could you please let the scepti- 
cal know that the pirated Minerva 
does exist - | bought it at Miinster! 
They guy selling it was apparently 
too uninformed to realise itwasn't 
genuine. It was a very early 1.66, 
anddidn’teven work without much 
tweaking. It was no April Fool. 

On a slightly different tack, the 
eprom in the MKT Minervas (the 
real ume clock, etc.) is identical to 
the MKI. It is worth pointing out 
that the Minerva clock is only 
connected to the QL by a serial 
bus, The protocol for changing 


this clock is extremely compli- 
cated, and QL crashes will not 
corrupt the clock, unlike all other 
QL clocks, including the memory- 
mapped Gold Card clock, In fact, 
we recommend users of both to 
unplug the Gold Card battery. Itis 
possible to crash the Minervaclock 
when the device is being trans- 
ported outside the QL. If yours 
becomes corrupted, then 
EXEC_W the program 
MINICONFIG_OBJ to 
reconfigure it. Minerva MKII 
needs version 2.26 of the Gold 
Card, or greater, to work properly 
with it. 
Tony Firshman 
TF Services 
London W2 


Editor’s notebook 


Activist Ron Dunnett (Qubbesoft, Quanta) has 
been looking for help in translating the text of 
German and Dutch public domain software into 
English, (see QL Scene), but so far even such 
offers as he has had have not borne fruit. It 
seems a pity that these programs should be 
under-utilised because of language barriers. 

We hear that Sir Clive Sinclair’s Zike bike is a 
little behind its production schedule. If it runs 
true to form, it should still have a strong followng 
in anumber of years, just like the Spectrum and 
the QL. 

A gentleman in Scotland who reads The Beano 
compares our correctness unfavourably with 
that venerable journal. | should hope so. The 
Beano’s publishers are fierce in defence of their 
honour, and | would be proud to know the 
proper form of the word OYAAH, but my dic- 
tionary, alas, doesn’t seem to include it. 

Spare a kind thought for Mike and Sue Lloyd, 
moving house (they very much hope - “we are 
still on a knife-edge”, says Mike) in these trou- 
bled times. And a thought for all the folk who 
can't, too. 
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SEISCSURERII 


Driven 


I thought I had printer drivers 
licked. My printers have been 
working fine for several years now. 
Then, for quickness, | decided to 
print a draft copy of a two-page 
document from Quifi onto my 
Brother M1109 printer. Horrors: 
each time the download to the 
printer was completed, it printed 
the last few lines of the page, and 
then continued with the rest of the 
document. Also the out-of-place 
lines were offset to the left, ig- 
noring the margin setting. 

I've tried juggling the printer 
codes in the driver, such as mak- 
ing the page length shorter than 
that set in Quill, but to no avail. 
Can anyone suggest what the 
problem is? Since I mainly use my 
DX-100 for printing documents, 
it will not hinder my work, but I 
am curious as to why the M1109 
refuses to print multi-page docu- 
ments without messing up the 
print. 

James C McGreehin 
Alva 
Scotland 


Editor's comment: This is just 
the sort of query that, were all our 


files in order and the many kind 


offers of help with printers that we 
had last year easily to hand, | 
Should be able to pack off to a 
responsible party. For now, any 
responsible party with a answer 
for James, please write to Open 
Channel. 


Unblocked 


Referring to my article Three in 
the Hand, over which there was 
some controversy, [should explain 
how [ arrived at my block-move 
timings for the three programs. I 
was using version 2 of Perfection 
at the time | wrote the survey.V3 
is faster, but this is not the main 
point. 

John Bunce (GL World July 
1992) was wrong - I did not forget 


any decimal points. Perfection can 
move massive blocks of text for 
miles and miles almost quicker 
than the average giraffe can blink. 
Nevertheless, it took this user, to 
the nearest second averaged over 
three similar attempts, 25 seconds 
of total user time, not just the text- 
move itself, to move one para- 
graph one page lower, All three 
programs, as the article stressed, 
performed more than adequately. 
This ts the process I used: | 
began timing with the cursor at the 
startof the block, With Perfection, 
you highlight the following text, 
move the cursor to the end of the 
block, mark the end of the block 
(by unhighlighting), define the 
highlit area as a block, move the 
cursorto where you want the block 
to go. and then move the block. 
This takes time. To avoid clumsi- 
ness, [ practised with each word- 
processor, and the final figure is 
the average of three cfficient tests. 
Michael Edwards 

St Mellons 


Editor's comment: Since this ts 
the type of program to which Per- 


fection ts often compared, I tried 


the same move on one of our 286 
machines running the most recent 
version of a well-known MS-DOS 
wordprocessor. 

Going through the same se- 
quence - that is, starting with set- 
ting the block - to move a 1 0-line 
block from top to bottom ofa large 


file took 55 seconds. 


This was longer than | had ex- 
pected! And then [| had to move it 
back again. The bulk of the time in 
this example was the actual file- 
moving. 

To move a four-line block down 
ten lines took about 15 seconds. in 
this example, the file-move time 
was virtually instantaneous, 

You can see by comparing these 


figures what proportion of the time 


(about .25 of a minute, assuming 
the user can see exactly where the 
text is to be placed and does not 
have to go looking for it) was 
taken up in setting the block and 
moving the cursor to the destina- 
tion position, 
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Perfection uses one more proc- 
ess (defining the block) than my 
test-piece, but moves the block 
faster over long distances. An- 
other well-known MS-DOS 
wordprocessor, for instance, 
moves its blocks faster than my 
test-piece, but also has a longer 
defining sequence. You wins some, 
you loses some. This ts the ball- 
park that a powerful word proc- 
essor is operating in. 

This ts arealistic way of assess- 
ing block-handling. Although fast 
file-handling is one of the greatest 
blessings, ina complex operation 
like block-handling, the text- 
marking and locating times should 
be included, as has been done 
here, 

There have been updates of two 
of the three programs surveyed in 
Mike's user report since he wrote 
it, All three programs were ver- 
sions which were on sale to the 
public and being used in earnest, 
and not beta-test or preview 
models, 


Busy Wait 


I have seen the article System- 
atic Machine Code Programming 
starling on page 45 of the April 
QL World, | was surprised to find 
Alan Bridewell advocating a busy 
wait, that 1s, a tight loop doing 
nothing with, | suppose, the in- 
tention of allowing other jobs to 
use the processor! The job doing 
the waiting is, of course, still us- 
ing cpu ime, which other tasks 
might want. Also, the delay de- 
pends not only on the number of 
times the loop is executed, but on 
the processor speed (Gold Card, 
etc.), Memory expansions, what 
other tasks are running, and so on 
as well. What he should have been 
using is the Qdos call specifically 
for this purpose: MT.SUSJB, 
which suspends (pauses) a job for 
some fixed length of time allow- 
ing other jobs to run. Something 
like this: 


-keyrow 

moveg #$8,d0 : Code no. for 
MT.SUSJB 
moveq #-1,d1 
job 

move #2,d3 ; Time inunits of 
1/50 sec 

moveg #1 ; Doit 

: Now the keyrow routine proper 
Iea_ keyr,a3_ ; Keyrow param 
table 


; Suspend this 


And so on. A similar change 
should be made to the other two 
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routines. Also, in the keyrow rou- 

tine as printed, the loop jumps back 

to initialising the counter rather 

than the NOP instruction, giving 
an infinite loop. 

Ian Jackson 

Ponteland 

Northumberland 


Alan Bridewell replies: Mr 
Jackson is quite correct. The best 
solution is to suspend the job to 
prevent excessive calls to the IPC. 
Why I didn't think of that at the 
time is beyond me - my only excuse 
is that lama self-taught program- 
mer, such mistakes are bound to 
crop up eventually. However, | 
must add that the tight loop does 
work, Although it wastes valuable 
processor time, it wastes far less 
than accessing the IPC several 
times in one keypress! And if it 
works, [tend to use it. But in future, 
I shall use MT.SUSJB. 

He is also correct in pointing 
out that the Keyrow routine as 
printed does not work. Unfortu- 
nately, 1 sent an early (bugged!) 
version to OL World for publish- 
ing, instead of the final version. 
Please accept my apology for this. 
Note, however, that the sample 
program which uses the routines 
does work, because it contains the 
correct version. | do try to test 
everything. | actually compile the 
output from the word processor 


for the articles, to check the pro- 


grams! This, ofcourse, won't work 


Jor the separate routines, because 


even if they compile, they won't 
run as programs. 

The Editor adds: Alan has pro- 
vided two sheets of updated listings. 
Users who would like a copy of 
these listings, please send an SAE 
to the Arewind office and I will 
arrange for copies to be sent. 


Health 


Mr. Freddy Vachha of Digital 
Precision has been in touch with 
me and spent a long time trying to 
analyse a fault which has been 
giving me trouble with some pro- 
grams. We have jointly come to 
the conclusion that it must be either 
my disk drives, or the Trump Card/ 
interface which is at the root of the 
problem. He has asked me up to his 
office together with my “kit” for a 
health-check/MOT (forthe kit, that 
is), hoping that we may once and 
for all sort out the problem. I shall 
take up his offer when ume allows. 

Michael J Grover 
Leatherhead 
Surrey 


Early Model 


] own an early Sinclair QL, se- 
rial number D12-063456, and I 
understand that this machine may 
have problems with some printers. 
Can anybody recommend to me a 
good printer which will work with 
my machine without too much 
messing around? 

K W Blackmore 
Stamshaw 
Hants 


Chess 


From time to me I have read 
that Psion Chess will not work 
with a memory expansion. The 
latest mention appears In OL World 
in Mike Lloyd’s review of the Gold 
Card in the June 1992 issue, 

Thavea 640K QL, and I find that 
Psion Chess operates perfectly 
using the boot program listed here, 
This boot program must be on the 
same medium as a copy of the file 
‘chesse” supplied by Psion. The 
original mdy cartridge must. as 
always, be in mdy2 at run time. 

Mdvy users should change flp| 
to mdyI in line 160 of the listing 
here. 

No special toolkit is required, 
and the system runs satisfactorily 
on JM and JS roms; probably on 
others, too, 

C B Storey 
Tyne and Wear 


Comment: Thanks to Brian and 
other Psion Chess players who 
conunented on this, 


Boot program for Psion Chess 


100 MODE 4 

110 OPEN 

#1 ,con_512x256a0x0)_32:CLS 
120 CSIZE #1,1.0 

130 CSIZE 3,1: AT 
2,12:PRINT”"QL CHESS” 

140 addr=184064 

150 a=393216 

160 a=RESPR(a-addr) 

170 LBYTES tipl_chessc,addr 
180 CLOSE #0:CLOSE 
#1:CLOSE #2 

190 CALL addr 

200 STOP 


Head Left! 


Referring to A R Kempton’s 
problem with his printer: to get the 
printer head to return to the left 
hand end of the printer, he must 


include the following in his 
printer_dat: 


PREAMBLE ESC @ 
POSTAMBLE CR 


Those are, respectively, a printer 
reset and a carriage return. 

The latter is required because, in 
Quill, if he leaves the cursor at the 
right hand end of the last line, then 
the last line will not be printed but 
will appear at the top of the next 
document he prints. 

Tf, however, the Taxan printer is 
not Epson-compatible, he must 
read the Taxan handbook to get the 
appropriate equivalent codes. 

A Owen 
Stowe by Chartley 
Stafford 


Re A R Kempton, Open 
Channel. O“L World July 1992, 
he should check that his printer 
driver has a CR character (code 
10/10) included in either/both 
of the PREAMBLE and 
POSTAMBLE strings. 

Chas Dillon 
Tamworth 


Like your subscriber A R 
Kempton. J] had trouble with my 
printer (a Brother HR-15) not re- 
turning to the left-hand margin at 
the end of a document, and then 
starting the next one in the wrong 
place. 

After exhausting my meagre 
store of technical knowledge 
to no effect, I decided to try 
guile. 

My first cure was to put a 
full stop on a new line at the 
end of each document, and this 
of course caused the carriage 
to return there, but now T just 
leave a blank line at the top of 
each document and, wherever 
the carriage is, it moves back 
to start the second line as 
shown on the screens. 

For the same problem with 
printing from Archive Database, 
the allernatives are to incorporate 
LPRINT as the first line of each 
PROCedure, or when necessary to 
type LPRINT “* before calling the 
procedure'you want, 

[ hope this helps. 

T Rendall Davies 
London N21 


Comment: Conventional and 
less conventional solutions there, 
which | hope will give assistance 
in both directions. The trouble with 
guile is that it can provoke coun- 
ter-guile from your machine tn 
some unexpected places. 
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In Part 2 of his Aba- 
cus spreadsheet, 

P H Warne shows 
how to deal with 
payments that don’t 
occur every month. 


ast month you started laying out 

the spreadsheet which prom 

ises to solve all the problems 

you have with your bank account 
- except how to keep it topped up! 

The formulae arriving at the latest 
payment date for quarterly and biannual 
payments proved the most difficult to 
compile. The principle used is to calculate 
the offset from a 3,6,9,12 sequence for 
quarterly payments (or a 6,12 sequence 
for biannual payments) for both the current 
date and the standing order date. The first 
offset is then deducted from the current 
month and the second added to it. A fur- 
ther 3 (or6) is deducted if the second offset 
is greater. The complications arise when 
that takes you into the previous year, and 
Abacus comes up with a date like 1991/00/ 
03! It took a long time to sort that one out. 

Table three gives the formulae to 
be entered. Two more constants for the 
current date are added to the table in 
column Al - the offset of the month from a 
quarterly and a six-monthly sequence. The 
formula in column C calculates the offset 
of the first payment date, adding 3 (or 6) if 
the offset is zero and the number of the 
current month is less than 3 (or 6). Column 
E assigns a value of 9 (or -6) if conditions 
are such that the most recent payment 
would be in the previous year, 3 (or 6) if the 
offset in column C is more than that for the 
current date, or zero. As with the monthly 
payments, both columns assign a value of 
15 if the current date is outside the limits 
one side or another. Column F combines 
the offsets with the number of the current 
month, subtracting 1 from the current year 
if necessary, to arrive at the date of the 
most recent payment. The formula in the 
monthly columns | to AGis the same as for 
monthly payments, but itis only entered in 
those columns which would apply to that 
particular payment. For example, for a 
quarterly payment first due in February, 
only the monthly formula in the February, 


Abacus: only 
following orde 


"Flag" column D omitted. 


month (col ()-6) /2) 


Monthly: 


+Bxx(8 to ))) 
Quarterly:- 
In column Ci~ 


(& to 2) /3))*3+0.1)) 
In column Ei- 


Bi-Annual t- 


Annual §- 
Brn 


if (GAF4>=days (Bxx 


where Mn=number of month 


May, August and November columns 
should be copied. 


Weekly intervals 


It is also possible to cater for credits 
or debits due at weekly intervals, or at 
intervals in multiples of a week, but these 
are treated differently. For simplicity, the 
total amount covered by the period be- 
tween the date of first payment and the 
current date is shown in the January col- 
umn. Although it is possible to break this 
total down into monthly sums, the formu- 
lae are all very long and in some columns 
Abacus has to be forced to accept them by 
subterfuge! It was felt that the end did not 
justify the means. The date of the first 
paymentin the current year is calculated in 
column F. The two formulae are shown in 
Table four. 

When the basic spreadsheet has 
been drawn up, any of the formulae for 
regular payments which are also required 


TABLE 3 - variants for un-expanded GL 
Date Constants will be in column AF. 
Formula in H3 (month headings) etc., will bei- 


Formulae in columns C (Quarterly only) & E (Latest 
Payment/Debit) will bet- 


if (GAF4< days (Bxx)s Bux, if (SAP 4o=daye(Dxx)sDxx>Bxx( to S)+ 
str ($AFS-| f (SAF S< val (Bxe(? to ¥)+1,0)4+100,2,0) (2 to ) 


if ($AF4<days (Byy) +15, int ((val (Byy(6 to ))/3-int(val (Byy 


Lfityy=15, Byy> | f(eAF4oedays (Dyy) »DyysByyl to S)+etr (@ArS 
~$OF7+Cyy-i f(Cyy>$AF7 or (HAF7=Cyy and SAFd<val (Byy(% to 
¥)+320)+100.2,0) (2 to )+Byy(8 to ))) 


if ($AF4<days(Dzz)»Bzz:Dzz) 
Formulae in Monthly columns will bei- 


and val(Brx(é to 
(& to ))>8MneFuxs"~-~-=") 


If weekly credits/debits are required: 
E is "Bxx" and the formula in column H is amended. 


Y<eMn and val (Exx 


the formula in column 


in the Credits section can then be copied 
up. In Figure one, you will see that this 
has been done for the monthly payments. 
The whole block A17:AGO was copied to 
cell A5 and the text in cells A5, F6 and A7 
edited. However, biannual credits must 
not be above row 9, to avoid forward 
referencing. 

The next thing to do is make a list of 
all your standing orders or direct debits, 
and the dates and amounts involved. Some 
standing orders will need two or more 
rows allocated to them. For instance, as 
Figure two shows, Poll Tax starts with 
two payments from the previous year’s 
assessment, then a single payment in 
April followed by nine others for a lesser 
amount. The second row shows the same 
date in both columns for the payment of 
the initial sum and the third row shows the 
dates of the first and last subsequent 
sums. Almost certainly, more than one 
row will be needed for mortgage payments 
to allow for changes in interest rates. 
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Accommodation 


Toaccommodate all these payments, 
expand the spreadsheet by inserting as 
many rows as are required for each category 
of payment (or credit). Note that rows are 
inserted above the cursor position or the 
row number typed. TO do this, place the 
cursor in the desired row and type F3 G | 
Enter nn Enter Enter. All the formulae are 
adjusted automatically, so provided the 
summation formulae include the sum un- 
derline row, any inserted rows will be in- 
cluded in the totals calculated. 

When the rows have been inserted, 
use the Copy command to copy the data 
and formulae in the top row of the section 
to the row below, by typing F3 C Bn:AGn 
Enter Bn+2 Enter), repeating the process 
as often as necessary to fill in the inserted 
rows. Then fill in column A and enter the 
correct dates and amounts in place of the 
dates so copied. For payments other than 
monthly, the formulae in cells Ixx to Agxx 
are only copied in the columns where a 
payment would fall due, and not across the 
whole row. Figure 2 shows how the fin- 
ished product should look. 

Because the Insert and Copy com- 
mands make it simple to insert a row when 
needed, there is no need to leave empty 


Tn 


A H B it 0 tEF i 
For current Balance 


LIBANK ACCOUNT #2345678 - ALN.Y. BODY 
2iACCOUNT FOR YEAR [991 
DATE= 4/12/91 


STANDING CREDITS: ~ 
bh Start datet Last datet 


ist/Latest 
! Creditt 
MONTHLY? = 
‘Pension Fund L9FL/OL/1b W LOFT /O3/16 H LP9L/O3/16 


LPSL/ONLG HAPEZ/OR/1G LIFT TL /L6 


OTHER CREDITS#~ 


OISTANOING ORDERS & DIRECT DEBITS#- 
Start date! Last datet 


Ist/Latest 
Payment: 


Nele W G'd Water 1971/05/01 
i LPL (08/01 
Building Society 1970/10/03 
3 1991/04/03 


1991/05/01 # 1991/05/01 
ASPL/E2/O1 # FFL /12/01 
FFL /03/03 # 1991/03/03 
1991/07/03 # 1994/07/03 
1991/08/03 = 1992/01/03 4991/12/03 
A9BR/O4/03 — L9PH/OB/0S LPH 12/03 
19O9/O7/14 # 199S/OI/14 = FL LL4 
1990/06/29 # 1991/02/27 & 1991/02/29 
LPH 05/29 # 1991/05/29 # 1991/05/29 
L9FL/06/29 # 1992/02/27 1991/11/29 


24tGcottish Life 
25H.F.C Trust 
26{Poll Tar 

an 

a 

2. QUARTERLY !- 
Br. Gas Service $99L1/02/EL 2 19FL/11/L1 # 1991/01/11 


1989/03/01 3 1993/05/01 6 1991/09/01 


(995/01 /31 
1995/09/28 


1991/01/31 
1994/09/28 


Union Subserip'n £990/01/31 
National Trust 1970/09/28 


CHEMUES (Payee and/or Number) 1~ 


Figure 2 - specimen completed account. 
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Balance Brought Forwardt----~ 


486.37 
590.34 


TOTAL DEBITS#- 


rows to allow for future changes. 

Cash withdrawals and payments by 
cheque or card transfer should be entered 
in the appropriate monthly columns below 
the standing payments. Itis easy to getinto 
the habit of doing this at regular intervals. 
Itis not necessary to calculate the balance 
on every occasion. 


Five seconds a row 


Calculation, using the F3 X com- 
mand, takes a few minutes (about five 
seconds per row for those with the full 
standing payments formulae). On typing 
F3 X, you are asked for the date for which 
the balance is required. This is in the usual 
English format D(D)/M(M)/YY, which is 
converted for Abacus use in cell Al3. To 
view the balance go to cell AExx in the last 
row (F5 AExx). 

The formulae in the totals cells make 
itpossible to obtain ‘end-of-month’ balances 
for any month, ignoring credits and debits 
which have been entered for subsequent 
months. This makes for easier comparison 
with bank statements, which are usually 
sent out at the end of the month. In fact, it 
would not be too difficult to add Nigel 
Bates’ reconciliation procedures at the end 
of the sheet, to make comparison with the 
bank’s statement even easier. Make a list 


G 1 H t 
ego to cell AE4S 


January 
358.64 


February 


Amount! 


446.37 


Cash 12/2 100,00 Cash 


Cash 


TOTAL CREDITS! - 


Amountt 


£23,862 
£23.77 


£14131 
126.43 
£115.66 


£33.76 
(B.B 
£31.20 
£28 87 
£28.50 


£17.35 
£40.00 
14,00 


£16,00 
£38.00 


7.64 
200.00 
45.00, 
2.00 
20.00 


£525.61 


Cash S/1 
BPOPE 8/1 
Bcard 370 
Cash 23/1 


150.00 BPOPB 4/2 
15,84 Cash 6/2 
34.30 Breard 371 

250,00 B.8.S. 372 

Cash 16/2 


£697.76 


ABACUS 


of the cell references for payments not 
shown in the bank’s statement, and type 
these references into the appropriate 
section of the reconciliation. 

At the end of the year, it is only 
necessary to change the year in cell B2 
(remembering that this is text), transfer the 
balance calculated for 31 December to the 
‘Balance Brought Forward’ cell (l4) and 
delete any rows covering payments which 
ended in the past year and are no longer 
relevant. 


Limited ram 


For those with limited ram, all dates 
must be quoted in terms of the current year 
and only the twelve monthly columns used. 
Flag column C is retained but only used for 
quarterly payments. The formulain column 
E showing the most recent payment is 
altered accordingly. In the monthly colurnns, 
beginning at H, the comparison need only be 
between the number of the month and not the 
days of the whole date. The main alterations 
are shown in Table five. There will also have 
to be adjustments to text in some places to fit 
into the reduced space. 

Memory can also be saved by de- 
leting any parts of a row beyond the last 
month in which a payment will appear, 
that is, beyond the month of the final 


fF of MG EUR OR 
DATE CONSTANTS! 
+ eee 


YEAR 1992 


Decenber January 1 LPR /12/03 


+ 


2/2 100,00 


ETAT AG 


ELS .AF 


BALANCE ON 03/12/1991 


7 


ABACUS 


payment. Since that row will be deleted 
entirely at the start of the next accounting 
year, no problems will occur when the 
new year is opened. Doing this will also 
speed up calculation a little. 


If the whole spreadsheet is printed 
out in condensed type (137 characters per 
line), it will occupy three A4 sheets. With 
the monthly text columns only 10 charac- 
ters wide, there is a margin on the right 


hand side of the third sheet. There is, 
therefore, scope for increasing the width of 
these columns without taking up more pa- 
per, but the information on-screen at any 
one time would be reduced. 


FA E Ct} 0 4 


' ; F 
ACCOUNT 812345678 


FIOTHER CREDITS? ~ 


1. 
12 

13: 

t4} 

15; 

16i TOTAL CREDITS: - 
LTiSTANDING ORDERS & DIRECT DEBITS tst/Latest 

18! Start Date: Last Datet Payments Amounti 
1911. MONTHLY? = 

201 1990/01/01 
2112. QUARTERLY = 

2 1F90/02/01 2 4995/02/01 3 1991/08/01 6.00 
2313, BI-ANNLAL!~ 

24h 1990/06/08 
2514, ANNUALS 

2h! 1PM/01/01 
27,OTHER DEBITS#~ 

a 

24 

30! 

3 

24 

3 

34) TOTAL DEBITSt~ 
Bi 

a 

3 Fsgure 1 - the basic spreadsheet, 


LY 


Rom Switch from 
QLEA only 


“A small but very significant error” has crept, 
according to Quanta, into July’s “otherwise ex- 
cellent” report of the Bristol Quanta Workshop. 

The Minerva/QL Rom Switch was mentioned 
in the report as being available from Qlas. 

Syd Humphries stresses that the Switch was 
designed by, and can only be obtained from, 
QLEA, the Quanta East Anglia Subgroup. 

The Switch costs £25 plus £1 postage (£2 
outside the UK and Europe). from QLEA, c/o 
Geraint Jones, 1, Bridgate Court, Thetford, 
Norfolk IP24 3AY, UK. Payment by sterling 
cheque to QLEA, 

Syd sends his best wishes to OL Werld. 


LP9SVOL/OL — 1991/00/08 $0.00 


W99S/12/01 1994/04/01 50.00 


19/01/01 = 1991/01/01 50.00 


For current balance, go to cell AExx 


ZIACCORNT FOR YEAR 1991 YEAR 1992 
a DATE! 26/9/91 January Februa, Hlovenber Decenber January 1991/09/26 
4, Balance Brought Forward? — 200.0 149287 
SiSTANDING CREDITS Ist/Latest q 
b Start Date? Last Dates Crediti Amounti % 
wreaty_ ete 
LPIOOL/OL = LPPS/OLYOL 1991/09/01 3.00 3.00 xy, Peeverd tas —— q 


DATE. CONSTANTS? 


0.0 50.06 650.00 
30.00 50.00 -——- —o — 
50.00 ee 
50.00 aia 
50.00 50.00 450.00 


BALANCE ON 26/08/1991 200.00 


CENE! 


Quanta organiser 
solves two in one 


A Quanta workshop ts being planned in Kent for 5/6 September 1992. 
The Venue is the Swan Hotel, Ashford Road (the A20), Charing, Kent. Tel. 
0233 712357. Overnight accommodation is available there and nearby. 
Bar and refreshments will be available. The organiser is Paul Merdinian, 
Forge House, Charing Heath, Ashford, Kent TN27 0AX. Tel. 0233 712857. 

Paul is launching his program QL Super Crossword Solver on the Mardi 
Computers label al the workshop. Supplied on 3.5in disk and designed to 
“work on any QL, even a 128K base model”, the program “works like 
electronic spellcheckers, accepts input of known characters and ? for 
unknown, and utilises controlled scrolling.” The software also apparently 
includes “Forty programs, twenty in SuperBasic, for you to hack to your 
heart's content, and 20 superfast stand-alone compiled versions. Contains 
over 20,000 words.” The program costs £10 inclusive of UK postage. 
Enquiries to Paul Merdinian at the address above. 
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SOFTWARE FILE 


‘AS FTWARE FILE 


INFORMATION 


Program: Qdesign | running under the Pointer] 


Environment (included). 

Publisher: Jochen Merz Software, Im stillen Winkel 
12, D-4100, Duisberg 11, Germany. Tel. 010 49 
203 501274, 

Price: Qdesign 2 recently released: £48, including 
laser printer driver, Upgrade from Qdesign | £13. 
Runs withrom version higher thanJM, and Minerva. 


he graphics/art market is surprisingly 

small for a mature product like the 

Sinclair QL. In the early days, software 

like Eve-Q (Digital Precision) and 
Artice (for those running the Ice pointer envi- 
ronment) dominated the market. However, nei- 
ther of these programs can now offer the power, 
sophistication and freedom of expression of 
CorelDraw/Dpaint/Harvard Graphics for the 
PC, or Dpaint for the Atari ST/Amiga. How- 
ever, the continued development of quality 
European graphics software - Painter (Progs of 
Belgium) and now Qdesign (Jochen Merz 
Software of Germany) will challenge estab- 
lished QL graphical software and bring the QL 
closer to the mainstream. Qdesign is advertised 
as a “Graphic and Design Program’, which 
suggests that Qdesign has aspirations in the 
DTP market. Unlike its graphics presence, the 
QL scene is abundant with powerful DTP pro- 
grams like DTP/DTP SE and ProPublisher 
(Digital Precison), PD2/PD2+ (Dilwyn Jones 
Computing) and now Qdesign from J Merz 
Software. 

Within 10 days of ordering, Qdesign arrived 
from J Merz Software (Germany). The package 
included a short but very informative AS manual 
(34 pages) and a program disk (3.5 in). The 
software is not copy-protected, which has to be 
applauded, and backup was straightforward 
(TK2 weopy command worked fine). The boot 
program was run from disk, first, as if back in 
time to the good old days of the ZX Spectrum. 
The Qdesign loading screen quickly appeared 
with the obligatory Space Shuttle. The program 
finished loading and the eye-catching Qdesign 
main page appeared. 

The first thing you notice about Qdesign is 
the Gpae2 pointerenvironment (by Tony Tebby 
of Qjump), [must admit to being a big fan of the 
Qpac2/Qimi mouse/pointer environment. The 
screen layout of Qdesign Is spacious with smart 
icons and easy-to-use menus. 

At this point, I will diverge a little. The Qimi 
mouse board with clock (from Quanta or from 
J Merz Software), connects onto the main QL 
motherboard, The instructions are clear and 
installation straightforward. However, the first 
batch of Qimi boards gave some QL owners 
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A F Wilson became a Qdesign user last November, 
and sees it as a route to advanced graphics on the 
QL for more recent roms. 


problems - the board pin connectors are a biton 
the short side, and with some QLs, the board 
has a tendency to spring out. Quanta, who 
make the board, were alerted to this fact and 
have fixed this for the second batch. Qimi is 
Gold Card compatible. Qimi works with any 
Atari compatible mouse (I picked up Truemouse 
for £14.99 atthe Glasgow All Formats Fair last 
year). [highly recommend the Qimi mouse and 
in conjunction with Qpac2 (now discounted 
from Care Electronics) results in a powerful 
and friendly WIMP-type environment. 


Pointer extensions 


Qdesign includes some Qpac?2 pointer envi- 
ronment extensions, and therefore does not 
require Qpac2 to work. Qdesign works equally 
well with both QL function/cursor keys and/or 
the mouse. The mouse makes art less restrict- 
ing and allows for greater artistic expression, 
The cursor is an arrow, and it is easy to locate 
on screen. To get started is simple: just start 
drawing on the sketchpad window, selecting 
icons from the Tools bar as needed - you have 
a choice of spray gun, text, paint can, shapes 
(square, circle and triangle - triangle includes 
other polygons, such as rectangle, pentagon, 
hexagon, etc.), different line patterns, magni- 
fication. and so on. All operations were instant. 
Clicking on the scrollbars at the bottom (left/ 
right} or right of the screen (up/down), scrolls 
the sketchpad window over another part of the 
page, however, the scroll bars could be a little 
wider in the y-direction. Selecting F5, or the 
Page icon, previews the entire page in low 
resolution (similar to Propublisher). F10 gives 
high resolution page preview. 

The top line of the menu bar includes a 
number of Qpac? icons. like putting Qdesign to 
Sleep, as a button (a button is a non-graphic 
icon) or Resize Qdesign or Move Qdesign. The 
bottom line of the menu bar, is the options 
menu Disk, Print, Font. Options, Block, Status. 
Blobs, Help and Quit. The last wo options are 
self explanatory. The Disk menu is compre- 
hensive with an excellent intelligent file han- 
dler, Qdesign is able to identify the graphical 


file format to be loaded. and automatically 
loads PD2 or Propublisher or standard QL or 
Qdesign (compressed/uncompressed) or Atari 
ST (monochrome) sereens into Qdesign. 
Qdesign can also save in any of the above 
graphical file formats. The ability to load/save 
Propublisher screens is important, particularly 
to Perfection (Digital Precision) users who are 
able to include Propublisher pages into 
wordprocessing documents. The Disk menu 
also includes the usual file utilities like Format, 
Directory, Device, Printer Driver and Configu- 
ration file. This menu also allows loading and 
saving of parts of screens (Cuts) and loading 
and saving of patterns, Patterns are useful for 
repetitive effects like carpet design. The Disk 
menu allows users to load standard QL fonts 
(or founts) and now Vector fonts (a first for the 
QL). Vector fonts supposedly give improved 
on-screen text, analogous to text printed on a 
laser printer compared with dot matrix printer. 
Certainly, the vector fonis provided with 
Qdesign are impressive. However, the pros and 
cons of one technology over another is outside 
the scope of this article. 


Compatibility 


The ability to load standard QL fonts allows 
compaubility with other graphics programs 
and font designers. Already three different 
screen font technologies exist within the QL 
graphics/DTP market - standard QL, High 
Definition and Vector. In the interest of com- 
patibility, hopefully software vendors like 
Digital Precision, J Merz Software, Progs and 
Dilwyn Jones Computing will modify existing 
software to cope with all three font technolo- 
gies. Unfortunately, Qdesign does not include 
a font editor. A number of standard font editors 
are available from other software vendors and 
from PD libraries and J Merz has just released 
Vec-Edit. a vector font designer. To view the 
fonts loaded, select the Font menu, all fonts are 
previewed and the user selects the desired font 
from the list. The ability to perform certain 
functions/operations on fonts is discussed later, 
Qdesigns compatibility with virtually all screen/ 
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DTP tormats is welcomed. 

However, in conjunction with Print menu, 
the user has a extremely powerful graphics 
print dump, as powerful as Grafix (Digital 
Precision) but with better user interface. The 
printer options available include altering the X 
and Y resolution, print quality (number of print 
head passes) and Colour (shading on mono- 
chrome printers). Additionally, the user can 
specify Block, Screen, Window or Page. The 
printer output can be Portrait or Landscape 
(sideways). Mirror imaging is also supported. 
The print dump quality is superb, especially 
with 24-pin printers. Laser output is supported 
- J Merz Software provides an upgrade version 
for an extra £7. 

A problem with Qdesign was the inability to 
escape a print dump once started - essential if 
the scaling was wrong. Atthis point it is worth 
noting a fundamental difference between 
Qdesign and Propublisher. Qdesign sketchpad 
is white ink on black paper, however, it prints 
out in reverse, ic black ink on white paper, 
whereas Propublisher provides black ink on 
white paper for both screen and printed 
hardcopy. There are two instances when this 
becomes important: 


(1) Printing a Propublisher screen from 
Qdesign to take advantage of the 
excellent printer driver. 


(2) Saving a Qdesign screen in Propublisher 
format for use within Perfection, 


In both cases, the DTP page will have to be 
Recoloured, This function can be performed in 
both Propublisher and Qdesign, Recolour 
Window is selected from Options and Recolour 
part of a screen (known as a cut) is selected 
trom Block. Therefore to recolour a Qdesign 
page requires using Recolour from two menus, 
A more satisfactory method would be to have 
one Recolour selection with the ability to specify 
the page (unfortunately too many graphics/ 
DTP do not cater for page (global) operations), 
screen, window or block (cut). Qdesign does 
allow page colour inversion (why invert instead 
of recolour?), which should do the trick for 
normal monochrome print dumps. Other 
functions available from the Options menu are 
CLS page/window, mode 8 to 4, reduce, outline, 
enhance and monoise and swap screen. 


Block menu 


The Block menu, as its name suggests, deals 
with cut and paste, essential tools in DTP. 
However, as above, page cut and paste is not 
catered for, although this could be easily im- 
plemented on Qdesign (select PIO, and using 
Block menu to cul the appropriate section of the 
page, u magnified window at the bottom of the 
page just displaying the cursor line would make 
fora more accurate cut), Block operations are 
so straightforward that they require very little 
explanation Cut, Paste, Erase, Move, Recol, 
Mirror, Rotate and InOut. With Cut and Paste, 
and Move, the defined block is copied into a 
buffer and the block is displayed on screen as a 
boxed outline which can be relocated on the 
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page using the cursor keys or mouse. Rotate Is 
a combination of 90-degree rotation with the 
ability to enlarge, however, no box outline is 
available to indicate the original dimension, 
which is a pain. Rotate needs to be updated, to 
conform to Cut and Paste, and to allow full 
rotation (0 to 360 degrees). A nice clock icon 
with degree markings would do the trick. 

The Status menu is packed with tool functions 
from brush types to italic slanting (left or right). 
The Status menu has four functional toggles: 
Under, Over, Fill and Good - and five new 
menus - IPWSZ, Blobs. Mode, Csize and 
VCsize menus. IPWSZ is short for Ink, Paper, 
Width, Side and Zoom menu. Good, which 1s 
short for ‘precision quality’, slows down the 
following operations: InOut, Mirror, Rotate 
and Print. As output quality is enhanced, in the 
same way as for printers, the print speed is 
sacrificed for NLQ text compared with Draft 
text. Mode specifies the colour resolution - 
two- or four-colour - and the graphic resolution, 
A word of warning: once the colour mode has 
been selected you cannot change it. Colour 
mode 4 is the best mode, but requires more 
memory. Clicking Qdesign or selecting F9 
displays the user number and the memory lett. 
It would be nice to see a visual representation 
of the memory left, at all times. A fuel gauge 
type icon would be a useful indicator. 

The Blobs menu allows the user to select 
different brush types and previously saved 
patterns can be loaded into the menu. This is 
handy for wallpaper or carpet or any other 
designs that require repetition. Csize and VCsize 
are font tools. Csize is as found in SuperBasic; 
refer to the QL user manual or QL World's New 
User Guide. VCsize is new to SuperBasic us- 
ers, and offers users many font possibilities, 
similar to Propublisher toolboxes (Digital Pre- 
cision). Although the VCsize options are pow- 
erful, they are self explanatory: Mirror (X and 
Y), Shadow, Pixel, Bold (Left, Right, Up and 
Down displaced), IBM/QL font, Csize (X and 


Fill 
Under 


Y), Italic (Left or Right slant, angle 0 to 180 
degrees), Outline, and Def-Grad. The last op- | 
tion adjusts the angle of a text string on the 
screen (0 to [80 degrees). 


Qsnap 


Qdesign comes with an additional utility, 
Qsnap. Qsnap allows the user to capture either 
whole or parts of screens from any software. 
This is of use to game reviewers, or software 
authors writing documentation or any user 
needing a screen dump to file. Qsnap was used 
to obtain the graphics accompanying this arti- 
cle. Once the screen dump or snapshot is on file 
it can be loaded into any Graphics or DTP 
program for printing or whatever, Both Qpac/ 
or Oram (Tony Tebby/Qjump) and Presgraph 
(AFW Software's add-on utility for the com- 
munications program Terminal from TF Serv- 
ices) allow screen snapshots. however, Qsnap 
can also take snapshots of part screens. 

The manual is well written, short 
and concise. It includes information 
on 

Qdesigns file format for those interested 
boffins, and includes information on 
incompatibilities, First of all, Qdesign needs 
expanded ram and disk system and will work 
with the Atari ST QL emulator, however, the 
version T tried will not work on QLs with pre- 
JS roms or Minerva roms below 1.84, At a 
recent SQLUG meeting, Qdesign was tested on 
a number of machines with the following ob- 
servations: 


(1) JS + Trumpeard 2 + Qimi: perfect. 

(2) JS + Gold card: some of the menu names 
(Disk, Print, Block, Options) didn’t appear on 
sereen at boot up. If you moved the cursor to 
where they should be and pressed space bar, the 
menu displayed without further inconvenience, 

(3) JM + Trumpeard or JM + Gold card or 
AH + Gold card: all didn’t load. 


Csize 0,0 
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Width 4 
Sides 3 
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In actual fact, | was surprised at the number 
of users still not using JS or 

Minervaroms. Overall, I was very impressed 
with Qdesign, Qdesign will do for graphics that 
Perfection did tor wordprocessing. In addition, 
Qdesign can double as a printer dump utility 
and its graphic file compatibility is second to 
none. The Qpac2 pointer environment certainly 
enhances the product (remember Qdesign does 
nol require Qpac? to run as all the necessary 
extensions are included) and a mouse (¥ia Qimi 
interface) is essential forthe serious user, How- 
ever, Qdesign lacks the text/wordprocessing 
file-handling capabilities of PD2 and 
Propublisher and as such still requires some 
development if DTP is the ultimate goal. 
Qdesign will suffer from the JM/AH rom 
incompatibilitics, however, QL users are an 
ingenious lot and a suitable patch is probably 
just around the corner. Hopefully. Qdesign will 
continue to develop, possible milestones being 
full DTP( V4), 3D-graphics (V5) and animation 
(V6). Lastly, the ideal companion for Qdesign 
or for that matter any graphics/DTP program is 
a hand-held scanner. Any ingenious person 
who can interlace cheap [BM PC hand-held 
scanners via the QL serial interface is onto a 
winner, 

For further information: 


SQLUG: 031 660 1826( Alan Pemberton - to 
join) 

Care Electronics (authorised Tony Tebby/ 
Qjump suppliers): 0923 894064 


Bis ths a seats 
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{Space shuttle reduced - see OPTIONS) 
(Reduction - height and length by 20%) 


A Quantum Leap in QL Wordprocessing 


Our new state-of-the-art wordprocessor, text87plus4 is now available In version 3. MILES ahead of any QL application! 


text” plus4 


+ ] USER FRIENDLY TO THE EXTREME 


« New well-written manual « Automatic setup and 
installation « Context-sensitive help e File selector boxes « 
Commands and key-presses highly compatible with Quill. 


+2 THE MOST POWERFUL QL WP 


« Extensive navigation and editing « Fast block and search 
{ replace operations « Reformats as you edit 
Remembers paragraph formats between sessions ¢ 
Extensive file commands « Spell Checker with browse and 
replace « Multi-Window Multi-Document « Page-Preview 
and Pagination save a lot of time and effort. 


+3 UNRIVALLED PRINT QUALITY 


« Nothing else can compete in text and character 
formatting « Fully supports proportional spacing and 
justifies correctly « Multlple paragraph formats with 
different margins and line-spacing « Right, centre and 
decimal tabs « Multiple columns plus headers and footers 


e Desktop publishing with several different page layouts in 
the same document . 


+4 FASTEST QL WORDPROCESSOR 


Amazing timings on an ordinary QL (much faster with Gold 
Card) and Atari ST with QL emulator. A 70 page text 
(24,000 words, 141,000 characters) was used e Load: 25s 
(STQL 17s) ¢ Save: 37s (STQL 32s) « Search / replace (with 
auto-reformat) 580 instances: 43s (STQL 14s) « Change 
Justification: less than 2s (STQL 1s) « Change right margin 
and reformat 65s (STQL 17s) « Move 10 pages from top to 
bottom (With manual marking and positioning); 35s (STQL 
15s) # Scroll screen 100 lines: 19s (STEAL 5s) 


Fully compatible with all QL ROMs, Gold Card, ST Ql, 
Thor. Requires disk drive and 256K memory. 


Prices (inclusive of Air Mail to overseas) 
text87plus4 £ 79.00 
2488 drivers for 24pin and Bubblejet printers £19.00 
typeset90-deskjet drivers for all HP Deskjets £ 19.00 
typeset90-Epson GQ5000, EPL4100 /7100 lasers £ 39.00 
fountext88 + founted89 £ 39.00 
Graphic driver for 9 & 24-pin printers with over 30 founts 


Ask for our free, comprehensive leaflets. 


SPECIAL OFFER! extended until end of September If you have paid over £59 for any other QL wordprocessor 
you can upgrade to text87plus4 for only £59. The manual from the other software Is required as proof of purchase (It will 
be punched and returned) .Send cheque, Eurocheque, to: Software87, 33 Savernake Road, London NW3 2JU 
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PERFECTION 


SPELLCHECKER 


Perfection puts a spell on Bryan Davies, without even sexisming him. 


INFORMATION 
Program: Perfection Spelichecker 
Price: £49.95 for basic program plus 
three dictionaries, 

£29.95 extra for Huge (Mega) diction 
ary, otherwise enquire supplier. 

SAE plus disk for small dictionary (ex 
isting owners of Spellchecker only). 
Supplier: Digital Precision Ltd. 

222 The Avenue 

Chingford 

London E4 9SE. 

Tel. 081 527 5493 


his program is separate from 
the PerfectionWP program and 
can be used either in conjunc 
tion with it, or on its own. That 
is, itis not dedicated to Perfection but can 
be used with text files from other editors 
and WP programs. It is a more ambitious 
project than previous QL spelling checker 
programs, both in the size of its dictionaries 
and in the facilities it does, or will, offer. 
Before going any further, please note 
that “dictionary” used generally in this 
context means a list of words against which 
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spellings can be checked, notalist of word- 
meanings in. This usage leaves the way 
clear for “word list” to refer to a file contain- 
ing words not found in a dictionary during 
document-checking, and stored as a 
separate, text file, for later conversion into 
a user dictionary. 

One of the prime aims during de- 
velopment was to create really big dic- 
tionaries, far beyond that provided by 
SpeliBound, Qtyp or Qspell). Not only that: 
it was thought worthwhile giving “one in the 
eye” to PC software by making the biggest 
dictionary well above the size of anything 
normally found on PCs. At about 360,000 
words, the “Mega” Spellchecker dictionary 
does not have much competition, on any 
computer! 


Sheer size 


Sheer size always creates problems 
on the QL, which is not the largest of 
computers in several respects. Memory 
size and processing speed are at a pre- 
mium, so Digital Precision have opted to 
supply several sizes of dictionary, to suit 
the available ram on users’ QLs. The larg- 


a Lit Wy =e lL x 
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est dictionary (called either Mega or Huge) 
can be used only when the QL system has 
1.5 MB of ram, which effectively means a 
Gold Card must be fitted, and a HD or ED 
disk drive. This dictionary file is too big to fit 
into the Trump Card ram, and too big to fit 
onto a DD (720 KB) disk. It might be ac- 
ceptably fast with the basic QL, but the 
extra urge of the 16 MHz GC processor 
doesn't come amiss. 

The standard big dictionary holds 
about 220,000 words (the numbers change 
as development continues, so don't take 
them as gospel) and can be used on a 
system with 768 KB Trump Card and DD 
disk drive. The medium dictionary has 
150,000 words; it, also, requires the 768 
KB Trump Card. The small dictionary has 
amere 77,000 words and can be used with 
256 KB Trump Card (or comparable 
memory expansion) and 360 KB disk drive. 
Various in-between sizes can be provided, | 
depending upon development and available 
space on the supplied disks. A word of 
caution: the memory sizes are nominal, 
and you may find that you need the next 
size up for practical use, as you may not 
find itconvenient to have only Spellchecker 
loaded when checking documents. For 
example, you may want Perfection loaded, 
which needs around 140-160 KB for itself, 
plus the necessary document space 
(roughly the same space as the file takes 
up on disk). 


On disk 


Spellchecker works on the QL, 
Thors, and the QL emulator on the Atari 
ST. Most of the dictionaries are too large to 
be supplied on cartridge; all combinations 
but the largest are usually supplied on 3.5- 
inch DD (720 KB) disk, and this one is 
supplied on HD (1.44 MB) disk. DP has 
thought about Gold Card owners who do 
not have a HD or ED drive but wish to use 
the largest dictionary, and the latter can be 
supplied “in pieces” on DD, together witha 
routine to stitch it back together into ram. 

The method of checking spelling is 
unusual; leastways, users familiar with 
other programs may find the DP approach 
different. The conventional way is to have 
the text file (document) loaded in a WP | 
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program, and tocall up the spelling checker, 
which then takes over from the WP pro- 
gram until checking is completed. As “un- 
known” (to the dictionary) words are en- 
countered, the user is asked to make a 
decision about them - typically add them to 
a supplementary word list, ignore them, or 
ask for alternative suggestions. 

Perfection Spellchecker is called up 
as a separate program. It takes control 
from Perfection if that is in use, but it can 
also be used when no WP (or editor) pro- 
gram is running. From here, though, it 
diverges. It has three modes of operation - 
as a concurrent checker of text you are 
typing into the current Perfection docu- 
ment (but not into any other program); 
Page or Block mode checking of the cur- 
rent Perfection document; and retrospec- 
tive checking of existing document files 
(not necessarily Perfection ones). 


Concurrent 


The concurrent mode is quite like 
that of SpellBound when it first came out, 
which attracted some criticism because it 
was the only mode available. The retro- 
spective mode is akin to the more useful 
combination of SpellBound 1 and 
FileBound, or SpeliBound 2. The Page/ 
Block mode is what is usually used on 
other computers. 

The divergence | mentioned may not 
be clear from the description so far. It 
arises because, whatever the checking 
mode, unknown words are not incorporated 
into existing dictionaries or wordlists dur- 
ing the initial checking process. The un- 
knowns are marked, visibly, and the user 
has the option to go through the document 
manually making corrections, or to submit 
it to processing by the separate Dictionary 
Utility (DU) program. 

The first illustration is of the Perfec- 
tion screen, with the MENU2> block of 
options displayed at the top, to show the 
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spell-checking options; the current docu- 
ment has been checked, but the highlight- 
ing of the marked unknown words “ARLL” 
and “RLL” (twice) is not obvious because of 
the limitations of the screen dump process. 

The second illustration is of the menu 
options when the Dictionary Utility is started. 
This latter program has several options; 
remove the marks from a spell-checked 
document and add the marked words to a 
user word list, sort a user word list alpha- 
betically and remove duplicates, sort a 
word list and remove duplicates then cre- 
ate a user dictionary from it, configure the 
program itself, and configure Spellchecker. 
It takes quite a lot of memory (something 
over 200 KB by default), because itreserves 
workspace to handle files to be checked, 
but the reserved space can be user-set 
when the program is configured. 


High speed 


With more than one operation needed 
to complete a spell-checking session, the 
speed of the individual operations needs to 
be high to give overall efficiency. There is 
not much that can be done to speed up the 
physical side of using the various pro- 
grams - the keying in of device and file 
name, selection of options etc. Assuming 
the user will normally be running Perfection 
and checking documents after production 
in it (comment on concurrent checking 
comes later), the procedure is to EXEC 
Spellchecker, either prior to or after start- 
ing Perfection, use the F3 F3 P (Pages) or 
F3 F3 B (Block) command to run the mark- 
ing routine (an interchange of information 
between Spellchecker and Perfection), then 
run through the marked document using 
the Search command to find instances of 
Strip 2 (the code used to mark the start of 
unknown words). 

The marking is done very fast - 40,000 
or more words per minute on a Trump Card 
QL, several times that with a Gold Card 
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fitted. This is about four times as fast as 
the best figures | have seen with other 
checkers on QL and PC. Strip 2 areas are 
shown by red highlighting (default 
colouration) and you have to remove any 
of these which mark words you do not 
want added to your word list. You can 
make these choices when using the DU 
routine itself, but the error words are then 
displayed on their own - not in context - 
and it will not always be obvious whether 
or not they actually are errors. 

One way to remove the Strip 2 code 
is to find it via a Search, move the cursor 
one character to the right, then use | 
CTRL+D. CTRL+G restarts the search 
each time. The aim is to leave only words 
which are to be added to your word list 
marked. This can be a lengthy process if 
there are many marked words which have 
to be unmarked. Repeated appearances 
of the same unwanted word donotall have 
to be unmarked, although Spelichecker 
marks all occurrences of unknown words, 
however many times they occur; DU al- 
lows you to deal with the first instance of a 
repeated word then ignore subsequent 
ones. 


EXEC utility 


Once the manual checking process 
has been completed, the file is saved and 
DU is EXECed. DU gets its job done quite 
quickly. It can be killed once itis no longer | 
needed, but removing it doesn't appear to | 
increase contiguous memory space. 

The initial marking of errors in a file is 
so fast that it might seem impossible to 
make it significantly faster, on any machine. 
Simply marking errors doesn’t get the job 
done, however, and there has to be another, 
“proofing” stage. You can edit the marked 
file yourself, and this is all you need do if 
you have no great problem with your 
spelling, and no desire to add unknown 
words to a word list. That is, if you make 
typing errors, butcan normally correct them 
as soonas they are spotted, there is no real 
need to continue to the next stage (using 
the Dictionary Utility). 

Having to switch to an external rou- 
tine and then manually accept or reject the 
errors naturally adds considerably to the 
overall time taken. During the review period, 
there was a fair amount of discussion on | 
speed of WP programs in general, and 
tests were done ona large (40,000-word) 
file to see ‘if the overall time taken for a 
complete spell-checking, -correction and 
word-list updating operation was materi- 
ally different in one WP program when 
compared to another. The Perfection 
Spellchecker was definitely the faster of 
the programs being compared. If the file 
was just marked and then checked manu- 
ally, the speed difference could be con- 
siderable; putting the checked file 
through the DU routine reduced the per- 
formance advantage to maybe 15-30%, 
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which is still a clear mar- 
gin. Not making your own 
word list, to hold any words 
not in the dictionary used, 
speeds up checking con- 
siderably, but being able 
to create your own diction- 
aries is obviously an at- 
traction for many users. 


Decisions 


Whichever way you go 
about getting a computer 
program to check your text, 
you can't escape having to 
make decisions yourself. The 
program says something is 
wrong, but it is up to you to 
say what it is. Spellchecker 
offers no alternative spellings 
for words it doesn’t recog- 
nise in the text; if you aren't 
sure what spellings are, you 
have to get out a paper dic- 
tionary and check. The com- 
petitive QL spelling checkers do offer 
alternative spellings, but the function is 
very basic. The first few characters of the 
error word are taken as the basis and a 
selection of other words having the same 
starting string is displayed. If the error 
was of a type where, for instance, the first 
letter was typed incorrectly - e.g typing 
“xar” instead of “car” - any alternatives 
offered are unlikely to help. DP argue 
that, unless alternatives can be offered 
on phonetic and interpretive bases as 
well as a simple character-comparison 
one, there is no point in providing the 
facility; as the QL really hasn’t (yet) got 
the power to handle such comprehensive 
checking, and the cost of incorporat- 
ing it could not be recouped in the 
small QL spellchecker market, it is 
best left out. 

Not all users will agree, as certain 
types of error are such that comparison- 
based alternative spellings actually do 
provide the required answers. Some 
standard transposition errors, such as 
typing “thta” instead of “that”, will produce 
alist of alternatives containing the correct 
spelling, in Qtyp or SpellBound. But you 
will have to resort to using the paper 
dictionary at times, whichever QL checker 
you use. 

Checking files outside of Perfection 
is quite straightforward and requires only 
Spellchecker itself to be EXECed and the 
Alt+Capslock key combination pressed. 
It doesn’t appear to matter what the text 
file type is. Spellchecker goes through 
and puts a top-hat character (*) against 
every word not found in the dictionary. 
Provided the originating WP or editor 
program can search for that character, it 
is then easy to find all the unknowns and 
deal with them. Word lists can be created 
in the same as way as with Perfection 
files. 
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User choice 


The concurrent checking mode is 
not something which DP makes a lot of. 
The instructions indicate that this mode 
was put in purely because some users will 
have got used to having it, as owners of 
SpellBound. DP doesn’t recommend it, on 
the basis that it is obstructive. It certainly 
does slow down the flow of typing, but QL 
users in general are not going to be “ma- 
chine-gun” typists and may not really be 
unduly disturbed at being stopped every 
time they type a word incorrectly. 

The awful behaviour of the original 
SpellBound (fixed in SpellBound 2), where 
it tripped out at the slightest provocation, is 
a thing of the past.The Perfection 
Spellchecker behaves well, remaining ac- 
tive even if you move the cursor back to 
previously-typed text and make changes. 
It beeps on errors only at the point a word 
de-limiter is typed, which is usually when 
you type a Space after the current word. 
SpellBound beeped immediately a string 
of characters didn't make sense to it, re- 
gardless of whether or not the end of the 
wordhad been reached. Having been given 
the beep, you retrace your steps, make the 
correction required, then carry on. You 
don’t have to make corrections there and 
then, as Spellchecker inserts one of DP’s 
collection of unusual characters - a capital 
X above a small x - after each unknown 
word and you can edit them later. A small 
point, but the marker replaces the Space 
(or other de-limiter) between the unknown 
word and the next one, and you have to re- 
type the space after deleting the marker. 

An illustration is give here of the 
Perfection screen during a session of typ- 
ing with Spellchecker active in the concur- 
rent mode, to show both the marker char- 


ould 
wt any 


puts in at the ends of 


t mod Woare under no 


at the tine = Wye WW can ignore them 


Once the current document has been edited to get rid of mis 
be run through the Dictio 
the unknown words cam be 
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es d 


acters and some of the types of error that 
are picked up (or not, in one case). 

Despite DP’s reservations, concur- 
rent checking is eminently usable. It has 
the distinct advantage that the spell- 
checking job is over and done with straight 
away. If you type relatively slowly, don’t 
make mistakes every few words, and make 
typographical errors rather than being bad 
at spelling, this mode should be quite sat- | 
isfactory for you. 


Games coming 


At the start of this article, it was implied 
that the current Spellchecker is not the end of 
the line. A good, big dictionary can be used as 
the base for a variety of word games. Forthose 
interested in word games, this willbe one of the 
main attractions of the program. The intention 
is to offer a variety of additional functions, 
making use of the remarkable size of the 
dictionary and the high speed of checking. 
Development has been going on for some 
months, and we should soon see some of the 
fruits of this. 

Those whose memories stretch back 
to the QSpell checker sold by Eidersoft in 
the middle 80s will recall that it had some 
good functions, such as finding all words 
containing a given string of characters, but 
was spoilt by slowness and some truly 
memorable dictionary corruption problems 
(my copy invented thousands of “words” 
suchas “shortcircuiteding” and “sexisming” 
and added them to the dictionary). 

The Perfection Spellchecker will, in 
future, provide functions for the crossword 
puzzler, the anagram enthusiast, and | 
anyone else with an interest in words for 
their own sake. Maybe we will even see 
some form of contextual and/or grammar 
checking. The program will then provide 
both utilitarian and recreational benefits. 
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device. 


Simon Goodwin exercises the QL vocabulary and 
shows how to send neat columns to any Qdos 


his new DIY Toolkit project 

generates neat form atted re 

ports on the vocabulary of your 

SuperBasic interpreter. It suits 

all QL systems from AH to 

Minerva, and requires only 276 
bytes of memory. This means that there’s 
not much hex data to enter, from Listing 
two, to get the versatile VOCAB command 
on your QL or emulator. 

The VOCAB extension was sug- 
gested by reader David Moseley of Cov- 
entry, prompted by the deficiencies of 
Toolkit 2's EXTRAS command. “EXTRAS 
is irritating even for Toolkit 2 on its own", 
writes David. “With additional keywords 
being added, and especially with the po- 
tential explosion which SET can bring, itis 
quite exasperating watching them scroll up 
the screen twenty, or so, at a time.” 

| have found the same problem when 
testing new keywords and programs, un- 
| certain of the names known to my system. 
Even if | set_ SCROLL 10 and CSIZE 1,0, 
to boost the text output speed, the EXTRAS 
list leaves much to be desired. 


Column widths 


VOCAB, short for VOCABULARY, 
has many advantages over EXTRAS. It 
uses a columnar display, adjusting to the 
width of the output window or device. If a 
name is too long to fit the column width it is 
truncated to ensure at least one space 
between adjacent columns. 

You can configure the column width 
|} and default channel to suit your own sys- 
tem, or change the command name with a 
few POKEs, as | shall explain later. 

VOCAB shows resident procedures 
and resident functions separately, so 
commands and SET functions, among 
others, appear in distinct reports; VOCAB 
9 shows the functions. 

These are only two of the ten types of 
Name Table entry; VOCAB can also report 
on SuperBasic procedure and function 
names, arrays, loop identifiers, scalar 
variables and unset names. The only type 
beyond its remit is type 1, expression en- 
tries which have no corresponding name. 

VOCAB takes two optional param- 
eters: a channel number, and a Name 
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Type. Possible Name Types are listed in 
the Table, and discussed in most books on 
SuperBasic and Qdos. VOCAB 0 shows 
names that would give the value * if 
PRINTed; these include device names like 
SER1 and flp1_BOOT, unless they appear 
in quotes in your program. 


Variables 


VOCAB 2 shows simple variables, 
including undimensioned strings, while 
VOCAB 3 reports the names of DIMed 
variables, and so on. If you need to docu- 
ment an existing SuperBasic program you 
can make a good start by loading it and 
using VOCAB to report the names it uses, 
in each SuperBasic category. 

VOCAB reveals all the names known 
to the current SuperBasic task, so itis most 
useful from interpreted Basic and fairly 
pointless in compiled code. If you use it in 
a MultiBasic task it shows the ‘local’ resi- 
dent names, which may differ from other 
Basic tasks. 

The command needs to know the 
number of characters that can fit on each 
line, in order to work out the number of 
columns available. This is easy enough 
when the output channel is a window, as 
the standard Qdos call SD.CHENQ returns 
the width in characters, taking account of 
the MODE and CSIZE. 

Disappointingly, SD.CHENQ only 
works if the channel is a window. It is no 
use for serial output channels such as files, 
SER and PAR. The QL operating system 
Qdos keeps no record of the ‘width’ of 
these channels. However the SuperBasic 
system keeps extra variables in its own 
Channel Table, and these are used if the 
channel is not a window. 


Width default 


The SuperBasic WIDTH command 
sets CH.WIDTH, at offset 34 in the 
SuperBasic Channel Table. This defaults 
to 80, which is why the PRINT comma, TO 
and exclamation-mark separators take a 
new line after 80 columns. Youcan change 
this with the WIDTH command. 

This example uses WIDTH and 
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CHR$(15) toselecta condensed printstyle, 
available on most matrix printers. It reports 
SuperBasic DEF names across 132 col- 
umns: 


OPEN #3,SER1 
PRINT #3,CHR$(15) 
WIDTH #3, 132 
VOCAB #3,4 
VOCAB #3,5 
CLOSE #3 


It may be that an incomplete line has 
already been sent to the channel, in which 
case the VOCAB report might start in the 
middle of a line, mixed up with the previous 
output. This is undesirable because it 
messes up the columns, so VOCAB takes 
anew line if the print position does not start 
out at the left margin. 

VOCAB always sends a new line 
when it has finished, like WSTAT, so you 
can tell that it has finished when no names 
are found, and the next thing you send to 
the device does not end up on the same 
line. 


Source code 


Listing one is the assembler source 
code for VOCAB, annotated for study and 
possible modification. | tested this with 
Hisoft’s Devpac assembler, and the same 
source should suit other assemblers too. 
The workings of the assembler code, and 
possible changes, are explored at the end 
of this article. 

You can obtain the original source 
code, plus documentation, on disk from 
DIY Toolkit, at Cwm Gwen Hall, Pencader, 
Dyfed, Cymru SA39 9HA, UK. Send £7 for 
DIY Toolkit Volume X (I'm running out of 
letters!), or call Richard Alexander on 0559 
384574 for details of the 20 volumes now 
available, spanning five years of DIY 
projects in QL World. 

The DATA lines in Listing 2 corre- 
spond to the code of VOCAB. If you do not 
own an assembler you can use the 
SuperBasic in Listing 2 to generate a copy 
of the code. The hex loader is the same one 
used for each DIY Toolkit project; you need 
only type the DATA, from line 590 to line 
790 inclusive, if you already have a copy of 


the loader. 

The loader checks the DATA state- 
ments and, if they are correct, generates a * Sinclair QL World DIY TGGLKIT — VOCAB extension 
small code file which you can load as * Yer. @.8, Copyright Simon N Goodwin, March 1992 


* 

follows: start lea.l define.al Point at name details 
mave.w $1i19.w,a2 Use the BP.IWIT vector 

a jap (a2) Link VOCAB toe BASIC 

START=RESPR(276) 7 

LBYTES FLP1 % VOCAB £ # CHANNEL% , J C NAME_TYPEZ 3 

CAE SOD ES TAR : b #8,d5 6 t #8 (RES PROC) 

yvoca moveg s ssume type 
CALL START moveq #1,d7 Assume channel #1 
empa.i a3,a5 Any parameters? 


beq-s defaults 
Once you have saved the code to tst.b 1(aS,a6é-1) Is there a # prefix? 


FLP1 _VOCAB_CODE (or some other file) and bpl.s na_hash 
entered these commands you can use VOCAB moveq #-1,d7 Flag it for later 


mMOve.wW $iiz.w,a2 CA.GTINT — get integers 
to report the names known to your system. po ros) 


bne.s bad_exit Return D@ error code 
subq.w #2,d03 Check parameter count 


Configuring bhi.s bad param Toe many parameters? 


bne.s one param 
move.w 2lal,aé.1),d5 Pick up the name type 


Once the code is loaded to address pick_chan move.w G@tati,ad-1),d7 Fick up the channel # 
F F bpi.s check type It should be positive 
START you can configure it with a few ig 
POKEs. These are relative to the start of bad_param moveg #-15,a9 BAD PARAMETER error 
j bra.s bad_exit 

the code in memory, and take effect before chan_errer moveg #-6,d0 CHANNEL NOT OFEN error 
or after you CALL the code. You could use bad_exit rts All errors exit here 
SET, from April 1991, to make the value of * pee a es Xk ‘ arate 
START resident and accessible when you aie aaa et ong iui aR ane pte 


bmi.s pick_chan Parameter is channel # 


have other programs loaded. mOve.w @(al,a6-1},d5 Parameter is name type 
POKE START+13.0 if you want check _type cmp.w #1,d5 Check for expressions 


beq.5s bad _param Reject. no name 


VOCAB to list unset names, by default; %i 
VOCAB 8 still gives resident procedures. defaults = mulu #40.d7 Find offset in table 


add.1 AB(aG) , d7 Add base ta offset 
You can POKE any other value from 2 to 8, pari S2tas) a7 Cheieir werk meaperad weil 


forscalars, arrays, FOR variables, REPeat bge-s chae_error Number is too high 
loops, Basic PROCs., FNs, Resident pro- move.1 @ia&,d7-1),d@ ID for output window 


A n @ bmi. h Ch ia 1 d 
cedures or functions. This POKE just sets ‘ead eetehdeben A ie oe ne Goan as 


the default type listed. x 


POKE START+11 to set the default get _ width movea.1 (ad),al Point Al at BASIC Buffer 
moveg Wait indefinitely Long 


output channel. This is currently #1, to suit wade SD.CHEN@ trap key 
USE, but you might prefer to divert it to #0, trap Al is an Aé offset 
#2 or #3, depending on your set-u ran iain anes tes 

yooe z 9g bs p. tst.1 Z signals ERR.OK 

The most interesting POKE sets the beq.s 
column width; values from 2 to 127 are nner Se ee et cae 
acceptable, though 2 only lists the first sromahng ae eae. Ripe ae en eas dae? 
character of each name, with a blank be- ji 
| move. | (aé),d@ Find the buffer again 

tween columns! POKE START+143,10 move.w @(ab,d@.1>,d& Fetch the window width 
reserves ten characters per column, suit- tst.w 4(ab,d@-1) Is the cursor at left? 
ing the residentcommands in Sinclairroms, get_ready beq-s got _width ; 
Toolkit 2, Speedscreen and DIY Toolkit pti oo ee eee Pe ee ee 
extensions. The default of 16 accommo- 7 
dates Turbo Toolkit, Tascopy, Qlib and 
other packages used regularly, while al- * Dé is output line width, DS is name type, A® is ID 
lowing reasonable space for SuperBasic * 

‘ fee got_width movea.1 24 (aG),as AS -> Start of Name Table 
program identifiers. move.1 28 (add.a4t A4 —> End of Name Table 
moveq #16,d7 Column width (1..127) 
Ne name move.wW dé&,d4 D4 is reom left on line 

W * 
check name cmp.b BlaS,aé.1)},d5 Check the type of name 
bne.s next name 
| might have dubbed this command mONed pial Rlesc High ward of D2 


move.w 2t(a3,a6.1),d1 Find Name List offset 


NAMES or WORDS, but decided that these Bee nge. null 
terms were likely to be used already as tst.w G(a3,ab.1) Is this a null entry? 

; Seat 4 beq-s next name 
SuperBasic definition or variable names. if not_nuil add.i 32 (a6) .d1 + Name List base address 
you find VOCAB hard to recall you can move.b Bla&,di.1),d@ Get name length (1+) 
POKE a new name of four or five charac- cmp.b 8,07 


ters into the code after loading: bhi.s easy_fit It fits the column width 


move.b d7,d@ Emulate Procrustes 
subq.b #1,da Allow at least ane space 


POKE_W START+264, 1358 ca ee = ee 
POKE_W START+266,16717 a te eke nee 
POKE_W START+268, 16747 


Turbo Toolkit simplifies this to POKE 
start+265,"NAMES”. Either way, CALL START 
to link the new command under the name 
NAMES. 
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Code commentary 


Listing one reveals the inner workings : 
7 * DB is length to copy to buffer from 1{A6,Di.L>? 
of the VOCAB command. If there is only * 7 . 


one parameter, a channel number is dis- copy_name move-b irlaks dt 03 Woe, ae . = — 
f . addq-1 sai vance throug ame lis 
tinguished from a Name Type by the addq.1 #1,a2 Advance through buffer 


presence of a hash prefix: VOCAB #0 lists subq.b #1,da Count one less character 
the default type on channel #0, while aS 9 7 copy .name 
pad spaces move.b #32.@(a2,a6.1) Add one space to buffer 


VOCAB 0 lists unset names to the default addg.? #1,a2 Advance through buffer 
channel. subq.b #1,da2 Count one less space 
Unfortunately the vectored routine 7 ants = pad_spaces 

that counts and evaluates the parameters * There are D7 bytes ready to be output from offset (Ad) 
also scrubs the separator details, so we * ee opis “ay, in, Sones 
need to look for the hash before calling herpes ee ate sac ia 
CA.GTINT. The program sets D7 to a bsr.s do_newline Take a new line 
negative value if the hash is found; D5, D7 Bre bad_exit ; 

; ft intact b move-w dé, d4 Start a new line 
and A4 are the only registers left intact by ie 47.44 
CA.GT routines. movea.1 (aé),al Point at the text 


The number of parameters winds up ee ad ees cahngpae pane iy a 


in D3; D7 is checked if there is only one, trap #4 Note Al is an offset 
otherwise the supplied values are loaded trap #5 mead Sher mist cg 
and checked. Name Type 1 gets ‘bad pa- aba = Bid ‘that, work? 


; ; bne bad exit 
rameter as expressions have no names. next_name addq.1 #8, a5 Advance down Name Table 


The channel must be open in the cmpa.i aS,a4 Have we reached the end? 
bhi.s check_name Keep going if A4 > AS 


‘ SuperBasic Channel Table, or a ‘channel diicieed iae-eoveq Newline ASCII code 
not open’ error results. moveq ; 10.SBYTE trap key 
trap 

tst.1 Flag the error code 
rts 


Cursor position » 


define dce.w One new PROCedure 
7 dc.w 
Once the channel ID is known we de-b 


need to check the width and current cursor dc.w End of PROCS; na FNs 
position. Display and window channels | = 

must be treated differently. The code at 
GET_WIDTH calls SD.CHENQ to read the 


cursor position in characters, but this only PEMark Sinolair QL World HEX LOADER v 3 


works if the channel is a window; otherwise REMark by Marcus Jeffery & Simon N Goodwin 
the information comes from CH.WIDTH : sa ee — 
F ; LS: RES : space: start=RESPR( space) 
and CH.CHPOS, held in the SuperBasic PRINT "Loading Hex..." : HEX LOAD start 
Channel Table. INPUT “Save to file..."if% 
Similar code is used in PRINT and SBYTES f$.start.byte | STOP 

INPUT when processing comma, TO and DEFine FuNetion DECIMAL(x) 

exclamation-mark separators. This ex- RETurn CODE(h8(x})-48-7*(h$(x)>"9") 

plains why the WIDTH command has no END DEFine DECIMAL 

effect on display output; itis over-ridden by DEFine PROCedure HEX_LOAD(start) 

the window details. 98 byte = @ : checksum = @ 
VOCAB moves to a new line unless vee oe 

| the cursor is already at the start of a line; 2 IF bg="*" : EXIT load_hex_digits 

SD.CHENQ activates any ‘pending newline’ 3 IF ee ass e. © Ki AiaSES Hes 

which may have been sent to the window } Se on ee rc ee oe _ 

but not yet performed. END IF 
AL SOT WIDTH We pais Ue ine sat = DECTMAL(S} ee DECIMAL(b+1) 

. ‘ 2 , = 2 = » 

bounds of the Name Table, which will be 3 IF hb<® OR hb>15 OR 1b<@ OR 1b>15 

searched for the required type of name, in PRINT"Illegal hex digit in: "jhe : 

D5. Notice how D1 is cleared before the oh gO EET 

Name List offset is fetched; this means that checksum = checksum + 16%hb + tb 

unsigned offsets in the range 32768-65535 “oe ; byte + 1 

are correctly processed. END REPeat load_hex digits 

READ check p * 
‘ IF check <> checksum 
Null entries : PRINT Checksum incorrect, Recheck data. “: STOP 
END IF 
} PRINT"Checksum correct, data entered at: "j;start 


: Null entries in the Name Table are END DEFine HEX_LOAD 


4 skipped. This check prevents the firstname — | REMark Space requirements for the machine code 
in the Name List appearing one or more @ DATA 276 

times in the report of unset variables, when ; 
VOCAB comes across unused Name Ta- 
ble entries, which consist of eight zero 
bytes. These redundant entries are 
| sometimes created when the Name Table 
| expands, and cleared out later by NEW. 
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Each name is copied to the start of 
the SuperBasic Buffer, followed by spaces 
to fill it to the column width. Long names 
are cut short to fit. This approach is simple 
and efficient, although it might seem less 
elegant than writing the name from the 
Name List. 

There are always at least 128 bytes 
available in the Buffer, and it's usually 
quicker to write the whole string from one 
place, rather than as two parts, name 
followed by padding spaces. The extra 
spaces at the end of each line are redun- 
dant, but keep the last column tidy if win- 
dows overlap. 

As each column is output VOCAB 
counts the number of spaces remaining on 
the line in D4; if this becomes negative the 
lineis fulland the loop calls DO_NEWLINE, 
before setting D4 to the line-width minus 
the space needed for the column waiting in 
the Buffer. 

Once all the names have been 
scanned, VOCAB falls into the 
DO_NEWLINE routine, which sends the 
new-line code CHR$(10) to the device and 
returns to SuperBasic. 


Further options 


The code for VOCAB could be ex- 
tended in several ways. An extra string or 
unset name parameter might specify a 


61@ REMark Machine code data 

6208 DATA “43FAG10234780110". “4ED27A@87EO1BBCB" 
638 DATA "67364433E8916492". "7EFF347801124E92" 
640 DATA “66165543628C6612", "3A31E8923E31E800" 
55@ DATA “6A1970F169027OFA". “4E754A876BEE3A31" 
66@ DATA "E8@@BA7C@00167EA", “CEFCOA28DEAEGO3B" 
670 DATA “BEAER@S346CEO2036". “78GG6BDAZ0492256" 
680 DATA "76FF70@B4E444E43", "4A80670A3C367822" 
698 DATA “30367B20600A2916", "3C3698G04A7 50804" 
706 DATA "8704617666B2266E", “@918286EOG1C7E19' 
719 DATA “38G6BA33E89O665C" , "72903233E8926606" 
72@ DATA “4A73E8@0674EDZAE" , “@020103618G0REO" 
730 DATA "6204100753001407" , "9400245615B61891" 
740 DATA "E8@@5281528A5390". "62F215BCQ020E800" 
75@ DATA "528A530262F49847", “6ABAG11EGBOOFF5A" 
760 DATA "3806984722563407". "70@74E444R434A8@" 
77@ DATA "“6600FF46508BB9CB”, "6298720A72054E43" 
786 DATA "4A8@4E75 aig geen “@5564F 4341426000" 
79D DATA "“BBOSPWAS” 22572 


‘wild-card’ similar to that used by WSTAT, 
so that only names which match a certain 
prefix appear in the report. In some cases 
it might be desirable to output the names in 
sorted order, or include other information 
such as the Name Table index of each 
identifier. 

The defaults presently determined 
by POKEs could be controlled by new 
commands, VOCAB_COLS, 
VOCAB_TYPE and so on, which modify 
the relevant code bytes or data values 
stored separately. This is tricky if you want 
the code to work in rom, as the options 
must be stored ata reliable address in ram. 

| am always interested to hear of 
suggestions or modifications for published 
DIY Toolkit code, and offer free DIY Vol- 


umes for the best suggestions. Please 
write to me, care of QL World. 


VOCAB parameters 


VOCAB 0 Unset Names 
VOCAB 1 Bad Parameter 
VOCAB 2 Scalar variables 
VOCAB 3 Dimensioned variables 
VOCAB 4 SuperBASIC 
PROCedures 
VOCAB 5 SuperBASIC FuNctions 
VOCAB 6 Used REPeat loops 
VOCAB 7 Used FOR identifiers 
VOCAB 8 Resident Procedures 
VOCAB 9 Resident Functions 


f 6UTF Services 
HERMES 


A replacement QL coprocessor (IC 8049 IPC) 


MINERVA 


The ULTIMATE aperating systen upgrade 
MTT NIMERIP roy with bottery for 256 byte: 


rom, CRRSHPROOF clock & interface (1?C) for 
moots etc. Can autoteot from battery ran. 


Other Features <ceamori to *KIAKID: 

too reset taitep nle Basic’ Faster 

che ore * Lightning) -string 
hand ng el? UHEN ’ Second screen/TRACE 
Foreign kybd orivers’ ‘Worn’ fast reset etc 
HKE to MEL UPGRADES: up to 1.79-25, Rest FREE 
| ‘send rom (PROTECT LEGS!) and disk or 2 mdve) 


[original NEI C400 MKIT 


ALL VERSIONS FULLY GOLD Card ¢ + Key k 
+ Resat/]Nt? 


- The first UK & scrolling bulletin 

d. Mow aver larger vith interrational 

TAD! ond WOnb of Files Cineluding 
the IHOLE King Jomes’ bible!) 


Dual soft 


Viewdata/UTS2-05100 OL TERHENAL EMULATOR 
Hultitasking for electronic mail, PRESTEL elc, 
CET dounload. Conpatible vith Tandeta Geornect 
OL noden/nodapter, Use Aconmect RSZ320 to drive 
urtuffered bodens. Conprehensiwe 5 wonud| 


Software (3,5" or adv) & manual £30 
FILE TRANSFER - to transfer {ext AND programs 
error free OCKUED betueen computers 


Pyoilabie for IEM compats, ATARI ST & Sinclair a 
Connects to Psion range with R&2320 comms Link 
Softuare £7.58 per m/c. Cable £18 (mane 2 n/cs) 


e27 - & 


Ait prices include URT and postage in the UK 


12 Bouverie Place, London U2 {RB (tel: 071-724 9053) 


SCROLLING BES FOR ORDERING/GL HELP and FAX - 871-786 2379 


ou 
Bo you find fast serial inpat uare)i able? 
De you want to run an MST 14668 bps soden? 


Tf you can say YES to any one of these, then 
this is a product you have been waiting for 


Pre extra input and cutput Lines 
invoked wore safely 
FITTING is a simple job, 


QL top (8 screws) ond replace the chip norked 
"8843' next to microdrive |, 


PRICE (including anual 4 softuare) {25 


Faulty QL boards (excl plug in ICs) 


en 


odNCLAdA 
STOP PRESS 


“Gives up to 19288 bps RELIABLE serial inout 
+ Indeperdent baud rates 
+ Stops keyboard ‘bounce 
+ Togeoves ‘fuzzy and ‘random’ sound 


(unuanted repeat chrs) 


Sinply renove the 


SPARES 


- £8 Circuit diags.. 
C8 1377 PAL 
INSTRUCTIONS 
8381 WA.... 
mu UA. 


* While stocks last. 


QL REPAIRS 


OLs tested vith Thorn EWI test rig 
and ROM softucre 


CHOY harduare extra if required) 


month guarantee 


MRIL ORDER ONLY 
BUCKS 
SLO OUR 


Serial 3 Button Mouse 


Remote Infra Red Mouse 
Externally fitted into SER2, a No 
Internal fitting required, 3 button mouse gives 5 more functions than the QIMI. 


Tel: 0753 888866 


“aS 
£55 


A SERIAL MOUSE FOR THE QL AND 
SER Mouse the Mouse Driver 


The SERIAL MOUSE SYSTEM enables a mouse to be used with the QL 
by simply plugging the mouse inlo the SERIAL 2 Port, and running a 
BOOT program. Common to all Mouse Syslems, programs with a 
Pointer Environment are required 

Four Packages are on offer 

1. 3-BUTTON MOUSE, SER Mouse 3.5 SOFTWARE. D-9pin to QL 
ADAPTER FOR THE SERIAL PORT. INSTRUCTIONS £45 

“1A. AS FOR 1 ABOVE, but including PC MOUSE DRIVER DISK. 


£12 extra 


2. CORDLESS [INFRA -RED} 3-BUTTON MOUSE. SER Mouse SOFTWARE 
D-25pin to QL ADAPTER FOR THE SERIAL PORT, BATTERIES & 


£55 


"2A. AS FOR 2 ABOVE, but including PC MOUSE DRIVER DISK. and 
‘VISULIZER’ a PC Mouse Painter Program on 3.5 and 5.25 disks 


£18 extra 


NB. We still have lots of QL’s, 1 & 2 Mb disk drives, peripherals and components. 
See previous adverts or contact us for details 


EEC LTD 


18-21 MISROURNE HOUSE, 
CHILTERN HILL, 
CHALFONT ST PETER, 


Paymnentierms: 

CWO, Accass, VISA ef cefara 
Cheques - allow 10 days 
Delivery- 

Postage - £3 

Praduct subject availability, EAOL, 


Fax: 0753 887149 
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ONE NAN'S 
SYSTEN 


A stroke of genius? David McCullagh has trained 
Archive to keep his competition team (and its 
accounts) going swimmingly. 


now seems a lifetime ago 
when | first took delivery of 
my QL. | was locked away for 
I weeks coming to terms with 
Quill and Abacus. Archive 
seemed beyond me. Initially 
my main uses were report and letter writing 
and basic accounts. The furthest! got with 
SuperBasic was writing boot programs. 
My Medic experiences are long gone 
and my setup now includes a JS QL with 
an 896K Trump Card (soon to be replaced 
with a Gold Card), Lightning, a Care 
regulator, Miracle hard disk and Miracle 
| 3.5in drives, a Keyboard 90 IF, a PC-type 
keyboard, a Philips Green Screen, recently 
an EEC Sinclair Colour Monitor, and a 
Star XB24-10 printer. | had intended to put 
all the QL parts ina Spem box but with the 
arrival of the hard disk, | will have to look 
at a PC-type housing. | also have a twin- 
floppy Thor 8. It was in constant use, but 
its limit of 640 K andiits inability to take any 
extra hardware now makesittoo restrictive. 
Aside from various spare parts which will 
someday form a backup QL, this is my set 
up at home. 
At work | have a twin-floppy Thor 
XVI with 1 MB, a Philips Green Screen and 
aStarNL 10 with sheetfeeder. All machines 
use a Miracle Centronics interface. Boards, 
roms, power supplies, etc. have been 
replaced on all machines over the years, 
but my soldering has not improved! | have 
tried to network the machines as per QL 
World and Quanta articles but without 
success. | will try again, so that | can use 
a backup QL as a print buffer for the many 
long printouts | make. 


Demise and reprise 


| had thought that my ideal machine 
was a Thor XVI with 1MB, and a 40 MB 
hard disk. Regrettably with Dansoft’s 
effective demise this is not very practical. 
The Gold Card and the plans for a Super 
QL seem the only realistic option. So the 
future still looks bright. 

My software experiences give truth 
to the adage: ‘You use 10 per cent of your 
software, 90 per cent of the time’. My main 
programs now are Cowo’s Qtop, Psion 
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Xchange, Archdev, Abacus, Perfectionand 
The Editor. Lightning and Toolkit I/ are of 
course installed. My wishes are for a good 
but flexible accounts package, and for 
Xchange onthe QL. |have Cash Trader, but 
could not get it to do exactly as | wished. A 
good Abacus spreadsheet covers wages. 

My main job is as manager of a 
sports centre in Dublin, while my second, 
unpaid, job is as manager/coach to a 
national level swimming club. In the former 
role | use the QL/Thor to write letters, 
reports, andso on; | write Archdev programs 
to maintain bookings/invoicing information 
and to maintain records, produce invoices 
and membership listings, and that sort of 
thing. 

The first of the main database 
programs | use is the Bookings Module, 
which takes information from groups who 
hire our facility, calculates term lengths 
and the costs involved, and produces 
invoices. | can produce lists of groups who 
start or end in a certain month, who owe 
money, when they paid, etc. | store the 
start and end dates in two forms. The first 
is dd/mm/yy, and as this is difficult to order, 
| also store it numerically by adding the ‘dd’ 
to ‘mm’ x 31 to ‘yy’ x 365, giving a number 
such as 726913. This permits the file to be 
ordered on start or end date and, by using 
the INT function, |cancalculate the number 
of days in a term. 


Books and accounts 


Three database files are used for 
‘bookings’. The first ‘d’ contains the details 
of the groups, such as names and 
addresses. When a group starts a new 
term, this information is taken from ‘d’ and 
passed to ‘b’ where the actual term details 
are added. A third file ‘c’ contains just one 
record, the current invoice number. 

The next database is a very basic 
accounts program. We use a cash register 
which produces daily readings. Our auditor 
requires a page per reading, so the readings 
are entered into acomputerised Day Sheet 
which simply stores the readings for Income 
and Expenditure and gives a daily balance. 
These are then printed out each month. A 
second file is maintained which, when the 
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last day of each month is reached, creates 
a Month Totals File. This file will then 
contain 12 or maybe 15 records, if |wanta 
six and twelve month total. 

| planto expand this to accept cheque 
details and lodgements. The last stage 
would be to combine this information to 
produce a monthly Income and Expenditure 
Sheet with current balances. My knowledge 
of accounts is very limited, so producing an 
Audit is beyond me and not really useful to 
me. 

Stock control, etc., are not bigissues 
and you have to be careful not to waste 
time on a computer if a manual system is 
quicker and functional. 

In my work as manager/coach, | find 
even more use for a computer. The club 
has over 100 members and, being a sport 
based on timing, their recordings are 
essential. The first of three databases holds 
all current best times of each swimmer, the 
Personal Best Module. The file is 
constructed so that each record contains 
all of aswimmer’s events and times. | could 
reprogram to use a record for every event 
and time for each swimmer, but aside from 
the great size of such a database, it is 
limiting, without a lot of programming, to 
produce one sheet with each swimmer's 
event profile. 


Controlled fields 


There is also the point that there are 
a set number of events in swimming, 
therefore the number of fields in the 
database is controlled. Again the format of 
menus is used with a ‘sedited’ screen doing 
much of the work. 

The .secorid ‘club database is the 
Clubil Module. Swimmers pay monthly and 
annual fees, and also take part in 
competitions for which entry fees are 
chargeable. Here | chose a different 
approach, in that every entry becomes a 
record. This leads to a large database, 
almost 5000 files, but it allows more 
manipulation of the data, andas the entries 
perswimmer increase there is no danger of 
running out of fields. A details file (‘d’) is 
kept, holding names, etc., and the 
swimmers’ account balance. Every time an 
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Proc bilbac 
REM Called by Shutdown to save dbf from Ram to Flp or Win 

SHOWHEAD : local cont$,an$ : print at 5,5;un$;"Save Files...";un$ 

while not instr("YyNn",cont$) :input at 9,5;"Continue (y/n) ";cont$ 

if instr("Yy",cont$) : kill fnl$ : kill fn3$ : kill fn5$ : print at 11,5;"Now saving..." 
backup fn2$ as fnlS : backup fn4$ as fn3$ : backup fn6$ as fn5$ : endif 


if instr("Nn",cont$) 


if instr("Aa",an$) 
else : if instr("Qq'’,an$) 
QUIT : endif: endif : 
endproc 

lot 
Proc mmenu 
while mm<11 : if mm=0 : 
else : 
if mm=10 
endproc 


Proc orcb 


endproc 
| | 


Proc seldev 


SHOWHEAD : let dv$="" : 
print at 10,10;"A = Flpl 
print at 12,10;"C = Winl 


if instr("Aa",dv$) 
let devs="flp2_" : else : 
endif : endif : endif 
endproc 


Proc showhead 
REM Screen Message 
cls : 


endproc 


: endif : 
print at 15,5;"Another copy/Restart/Quit (a/r/q)}? 
: SELDEV : BILBAC : 


REM Calls Procs after input from Showmenu. 
SHOWMENU : 
REM repeat "mm="" for other ShowMenu options 
: SHUTDOWN : endif : 


let devs="' 
_">: print at 11,10;"B = i 
_": while not instr("AaBbCc",dv$) 
input at 20,10;"Select Device (a/b/c) ; 
: let dev$="flp1_" 


print ;"TEMPLEOGUE SWIM CLUB - Invoice Module"; 
print tab 60;"Time ";time(): print tab 60;"Kbytes "; (memory())/1000 


endwhile 
";an$ 
else : 
: kill fn2$ : kill fn4$ : kill £n6$ 


endif : endwhile 


lie ot tod If 


else : if mm=1 : INMET : 


endif : endif : SHOWMENU : 


eee ee jt 


REM Called by START1, opens Raml_ files 
open fn6$ logical "c": open fn4$ logical "d": open fn2$ logical "b" : 


REM Select Data Device, choice of Flpl_, Flp2_ or Winl_ 
: print at 5,10;un$;"SELECT DATA DEVICE" ;un$;dv$ 


Flp2_" 


"sdv$ 
: else : 
if instr('"'Cc",dvs) 


: endwhile 


: while not instr("AaRrQq",an$) 
if instr("Rr",ans) 


Set "mm<" to last option +1 
FINDS : 


endwhile 


if instr("Bb",dv$) 
: let dev$="winl " 


tab 60;"Date ";today$ 


: START1 


ENTRY 


sload fn8$ 


tod 


entry in made, the ‘d’ data is appended to 
the ‘i (Invoice) file, the entry details are 
made, and the ‘d’ file account balance is 
updated. An invoice is then issued to each 
swimmer monthly. 

The third Module is used by both the 
previous two. The Details Module holds names, 
addresses, phone numbers, etc. In itself, it is 
simple in that it is a flat file with one file per 
swimmer added or deleted. However, it is 
central to the other two databases. 


Sorting swimmers 


A future project is to rewrite the 
Personal Best Module along the lines 
mentioned, of one file for each swimmer’s 
event. The reason for this is that many 
competitions have qualifying times. With a 
file per event, it would then be possible to 
call on all swimmers of a certain age who 
are inside a certain qualifying time (stored 
in a further database). It would also make 
ranking the swimmers easier, such as 
fastest to slowest in an event. 

| use Archdev because the Archive 
system of Xchange is, in fact, Archdev. | 
also use it because | sometimes use 


ArchRtm or Run-Time Archive. The 
advantage of ArchRtm is that it is faster 
than Archive/Archdev in loading, etc. The 
disadvantage is that Esc (unless it is 
trapped), causes the program to quit. It 
was meant to be used by commercial 
suppliers, as it tokenises code and users 
cannot access the programs. You must 
write _prgs in Archdev to use them in 
ArchRtm, so it's as handy to use Archdev 
allthe time, although I notice no advantage 
using it over Archive. 

Archive is a bit daunting at first but | 
found that with help from Chas Dillon 
through his Quanta Notes booklet (which 
aside from being ideal to learn how to plan 
alarge program gives many useful tips and 
information not available elsewhere, on 
Archive), Mike O’Reilly’s Database 
Management on the Sinclair QL, Albert 
Russell’s Managing data on QL Archive 
and Malcolm Johnston Advanced Archive 
on your Sinclair QL, that | can now write 
passable programs. | know that my coding 
is long winded (some listings reach 600 
lines) and with more knowledge it could be 
more efficient, but | find that it works. In 
fact, the main problem is Archive's lack of 
speed in selecting, searching, etc. | have 


looked at Flashback and others, but Archive 
wins for me because of the limitless tasks 
that its programming language can help 
achieve. My coding may also be long 
winded because | never finish a program! 
Well, | do, but then | start fiddling and see 
additions that | canmake and improvements 
in coding, sometimes years later. 


Helpers all 


| use the same basic system to write 
all my programs. | ‘borrowed’ it from Chas 
Dillon. The listings | have included indicate 
the skeleton _prgs | use. | start up with 
something like “Run Object ‘flp 1°", where 
Clubil is a _prg file saved with ‘object’ to 
become _profile, making for faster loading. 
‘Run’ requires a procedure called Start. 
Here |set up variables, then pass control to 
Seldev which gives a value to dev$, so that 
| can load data files from floppy or hard 
disk. It also gives a value to fn1$, etc., 
which are the global filenames. The files 
are backed up to ram, opened using ORCB 
(‘open ram club bill’) and control is passed 
to Showmenu, which is the programs ‘front 
end’ or menu from which non-printing 
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options are selected. 

| have included a few options in the 
listing, but you can have as many as you 
wish. On selecting an option, control is 
passed to MMenu, where the option 
selected is passed to the procedure 
controlling that option. | have not listed the 
details of these, as they are specific to 
each application. However, the most 
common ones resetall variables in a record, 
call a screen (sedited), ask for input using 
Sinput, then if you confirm that the 
information is correct, the record is 
appended to the database. 

Selecting option 9 calls up asubmenu 
which operates like Showmenu but which 
controls all output to the printer. In Clubil, | 
can print out all due invoices, select one 
member and print out a due invoice, print 
out all account balances etc. When printing 
is completed, control is returned to 
Showmenu. 

Selecting 10 from here leads to 
Shutdown. This procedure closes all files, 
then calls Seldev to select the device to 
which Bilbac will backup the ram based 
data files. Normally it’s still the same device, 
but | always keep two copies of data files so 
| can Bilbac to flp 1_ and when completed 
| can Bilbac to flp 2_, thus saving disk 
changes. Also as| have a hard disk athome 
and none at work | don’t have to switch to 
SuperBasic and WCopy RAM1_dbf, 
WIN1_dbf, Seldev offers me the option to 


copy to WIN1_. On completing the backup, 
| can return to Showmenu or Quit. Although 
| have not had lockups or crashes in a long 
time, thanks to Care’s power regulator, | still 
like to backup every 15 or 20 minutes. Good 
habits save a lot of tears. 

Using this system, | never leave a 
session without choosing Option 10, and 
so never have problems forgetting to close 
files. In fact, | have had no file corruption in 
a very long time, in part because all work is 
done in ram (which is the fastest way of 
manipulating data in Archive), and in part 
because of option 10, and also, | think, 
because | don’t use microdrives. 

| am weak on using parameters in 
Archive procedures. | know they reduce 
coding and are faster, but | never got the 
hang of them. Soon | will take a week off, 
rewrite the programs and use parameters 
- when the rush is over! 

| have been told that PC-type 
databases such as DBase require good 
programming skills and just as much 
frustration as Archive. Archive is limited in 
that itis difficult to get to grips with initially, 
and it is relative slow but overall | have not 
yet found any serious job which it could not 
handle. Compared with today’s databases, 
it does not have graphics, menus, etc., but 
it is free. | see that PC Archive will costs 
nearly £300, and | have not heard any 
plans to convert it for use on the QL. 

| have always though that the main 
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uses of computers were for word processing 
and database activities, and | find it 
surprising that no one has made a serious 
attempt at producing a better Archive/ 
DBase-type of database for the QL. 


PC not for me 


| had considered moving to the PC 
world, but experience with one, the 
investment | have in the QL, and the very 
high cost of PC software put me off. With 
the arrival of the Super QL, either through 
putting ittogether yourself or buying one off 
the shelf, the QL looks stronger than ever. 
The other evening | stopped, struck by the 
versatility of switching from The Editor to 
SuperBasic to Perfection to Archdev, etc., 
all in 1 MB. | know PCs can at last do 
similar, but not as easily nor as cheaply. 

Being in Ireland where there is no QL 
supplier, and where anything you can getis 
very expensive, and| amindebted to people 
such as Chas Dillon, Freddy Vachha and 
Digital Precision, QL World, especially 
Simon Goodwin, Bryan Davies, Miracle 
Systems and many Quanta members 
without whom | would never have gotten 
this far. My thanks to you all. 

If any readers want listings of any of 
my programs | will be happy to supply 
them, but there are few rem statements 
and deciphering them may be difficult. 
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ARCHIVE ANSWERS 


ARCHIVE 


A=N+S-W=E+R-S 


Robin Stevenson 
brings to book a 
bibliography 
routine - but it has 
many other uses as 
well. 


you have ever written some se 

rious non-fiction, the chances are 

you stuck a bibliography at the 

end (nicely put, Robin). Whether 
it's a school or college essay, a four-page 
village history, or a full-blown book, you 
should provide one, both to list your 
sources. and guide the reader for further 
information. 

lf you are already a database 
fan, then you won'tneed me to tell you that 
the best way to compile your bibliography 
isto computerise it. Allthe classic database 
elements are there: a mass of disparate, 
but structured information (authors, titles, 
etc.) to be placed in alphabetical order, 
and presenting in an orderly manner. The 
first part of that process is a simple Archive 
problem. Identify the various fields you will 
need, insert the data, and use the ‘order’ 
command to put it in order. 


Extraction 


As with most databases, the tricky 
bit is extracting the information in the way 
you want it. If the bibliography is just for 
books, the situation is fairly simple. You 
print out the author, title, publisher, and 
date, with suitable punctuation inserted. 
But there are complications. The refer- 
ence may be to a chapter in a book edited 
by someone else. So the editor, and the 
overall title need to be included. It may be 
an article in a journal, in which case the 
journal name and issue number should be 
included. There are other formats for 
newspapers, legal documents, etc., but 
we shall restrict ourselves to these three. 
You could add other specialist headings 
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BIBLIOG_PRG - Listing for Bibliograhy Database Management,. 


proc NewPile;Piles 

create File$ logical "bibliog" 
Author$ 
Title$ 
Year 
Publisher$ 
citys 
Compilation$ 
Fditor$ 
Journal$ 
Issues 
Comment $ 
UseThis 
endcreate 

endproc 


proc Identify 
reset : order Author$;a,yearja: display 
print at 13,12;"Include this Record? Y/N : 
while not eof() 
sprint : print at 13,40;" "3 at 13,403 
let answerS=upper(getkey()) 
if answer$<>"Y"; let answer$="N": endif 


print answer$ 
let UseThis=(answer$="Y") 
let bugfix=recnum(); update t position bugfix 
next : endwhile 
endproc 


proc IncludeAll 
reset : first ! while not eof() 
let UseThis=1 
let BugPix=recnum(): update : position BugFPix 
next : endwhile 
endproc 


proc OutputTo;X$ 
if upper(X$)="P": spooloff 
let Ucode$=chr(16) 
let LeftMargin710 
let WrapMargin=18 
let RightMargin=70 


"; spoclon screen : cls 


let LeftMargin-3 
let RightMargin=61 
let WrapMargin=11 
return 
endif 
spoolon X$ export 
let Ucode$="" 
let LeftMargin=0 
let RightMargin=80 
let WrapMargin=-0 
endprec 
b ——s 


proc PrintInit 


let CurrentMargin=LeftMargin 
let CurrentPos=LeftMargin 
let Underlining-O 

endproc 


proc PrintLine;x$ 
local Pos ,M 
let Sep$="-,.3: 
if Underlining! let Uline$=Ucode$ 
else : let Uline$="": endif 
let Max=RightMargin-CurrentPos 
while len(x$)>Max 
let Pos=Max: if pos?l 
while not instr(Sep$,X$(Pos)) and Pos>Max-10 and Pos>1 
let Pos=Pos-1 
endwhile : endif 


Sep$ ,ULineS 
myaye 
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yourself if required. 

Finally each entry needs to be 
correctly formatted. The name needs to be 
‘outdented’ from the rest of the text, and 
lines need to be wrapped around properly. 
Quill does all this without a murmur, but 
Archive needs a little persuasion - in this 
case, via a slightly tortuous, but wholly re- 
usable Archive procedure. There are also 
procedures to create a file, and extract the 
bibliography details. As a little embellish- 
ment, it allows you to select only part of the 
list before printing it out. You can build up 
a comprehensive reference on a subject, 
and only include the entries you require for 
a particular publication. 

Your complete bibliography could then be 
a valuable research aid, using the normal 
Archive locate, search and find facilities. 
There is plenty of scope for adding to 
these features. You could add a field to 
record where the book is kept (‘shelf 
3b’,'loft’,"reference library’, etc.). And if 
books are not your 

thing, it would be very easy to adapt the 
program to organise your record collection, 
photographic slides, or whatever, with fairly 
minimal changes to the program. 

Once the listings are entered, 
debugged and saved to disk/microdrive, 
you can start to enter your data. Rather 
than providing a complete program shell, 
we shall use the Archive ‘Command Line 
Interface’. Don’t let that phrase panic you. 
It just means typing commands at the 
normal Archive prompt. Some of 
these will be standard Archive commands 
(such as Insert, or Close). Others are the 
program commands such as NewFile or 
PrintList. Incase you forget the commands, 
there is a ‘help’ command, which will de- 
scribe the commands (both Archive and 
Bibliography) you may need. 


Using it 


Once you have tried it, the pro- 
gram should seem quite simple. Here is a 
brief description of how to use it. To create 
a new data file, you enter: 


NewFile; filename’ 


choosing a filename that describes its 
contents. When you return to a previously 
created file, you can use the standard 
Archive command Open ‘filename’instead. 
Youcan now enter details of the books you 
wish to include, using the ubiquitous ‘In- 
sert’ command. Obviously you can keep 
returning to a file to add extra books, as 
your research/enthusiasm grows. Foreach 
entry you will need to decide which of the 
three entry types it is, as the different 
types use different data fields. All types 
should include the author (or authors all on 
the same line), the title of the piece, and 
year of publication. If it is a journal/maga- 
zine article you should leave the next few 
fields blank, and add the journal name, and 
details of the issue and page numbers. 
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if Pos<=1: lprint : else 
if not instr(Sep$,X$(Pos)} and len(x$)>Pos+7 
let Pos=Post7?; let HS="-" 
else ; let H$="" 
endif 
lprint tab CurrentMargin;Uline$;Xx$(1 to Pos) ;H$;Uline$; 
let CurrentPos=CurrentPos*Pos 
Let X$=x$(Pos+1 to ) 
while x$(1)="" and len(X$)>1: Let XS=XS(2 to ): endwhile 
if x$="": bet X$="": endif 
if len(€X$): Iprint : endif 
endif 
let CurrentMargin=WrapMargin 
let Max=RightMargin-CurrentMargin 
if len(x$): let CurrentPos=CurrentMargin: endif 
endwhile 
Iprint tab CurrentMargin;ULineS;X$;U1 ine$; 
let CurrentPos=CurrentPostlen(X$) 
endproc 


proc Book : 
let Underlining=1!Printline;Title$: let Underlining=0 


PrintLine:" ":PrintLine;Pub]isher$+" ":PrintLine;"("+Citys+") " 


endproc 


proc Journal 
PrintLine;TitleS+”. " 
tet Underlining=1:Printline;Journal$: fet Underlining=0 
PrintLine;” ":PrintLine;Issue$+". " 
endproc 


proc Compilation 
PrintLine;Title$t+™. " 
PrintLine; "In "+Editor$+", editor, " 
let Underlining=1:PrintLine;Compilation$; let Underlining=0 


PrintLine;" "!PrintLine;Publisher$t" ":PrintLine;"("+City$+") " 


endproc 


proc PrintEntry 
PrintInit: lprint :PrintLine;Author$t+", " 
if Fditor$="" 
if Journal$="" 
Book 
else :Journal 
endif 
else :Compilation 


endif 
PrintLine;str(Year,2,0)+". 
endproc 


";PrintLine;Comment$: I|print 


proc PrintList 
local Spool$ 


print at 13,0;"Send To [P]rinter [S]creen or enter filename: " 


input Spool$;OutputTo;Spool$ 
order Author$;a,Yearja 
select UseThis)0 
first : while not eof() 
Printe@ntry 
next ! endwhile 
spooloff 
endproc 


proc Help 
cls : print 
print ” BIBLIOGRAPHY DATABASE” 
print 
print ” To Create a new file, 
print " To Open an existing file, Open <filename>” 
print " To Insert new records, Insert" 
print " To Identify the required records Identify" 
print To Include the entire database Includeal lL" 
print " To Print the bibliography PrintList” 
print “ To Close the file after use Close" 
print 


print “ To modify margins, Edit the procedure ‘OutpuTo'" 


print " To modify underline codes, Edit procedure 'OutputTo’" 


endproc 


NewFile;<filename>" 
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Ifitis a book, the journal informa- 
tion is left blank, but you should add the 
publishers name, and city of publication. 
And if it is only a chapter in a book com- 
piled and edited by someone else, you 
should include, in addition to the publisher 
information, the editor’s name(s) and the 
overall title of the 
compilation. 


Fairly crude 


The printing routine uses the 
fairly crude technique of seeing which 
| fields are blank to decide which type of 
entry it is. So make sure you don’t acci- 
dentally add spaces or other characters to 
fields that should be blank. Punctuation 
between entries is added automatically, 
so you should not duplicate this. The 
exception is within names of authors and 
editors. Names should be entered sur- 
name first, followed by acomma, and then 
initials, followed if desired by a full stop. 
Finally, there is an optional 
‘Comment field. This is particularly useful 
if the bibliography is for ‘suggested further 
reading’. You can use this to point out 
particularly important books on a subject. 
If you need to correct or alter 
entries after you have entered them, you 
canuse the normal ‘navigation’ commands 
(‘first’, ‘next’, ‘find’, etc.) to get at the 
record, and use the ‘Alter’ command to 
make the changes. 
lf you find a single line is too 
short to fit some entries on, the best solu- 
tion is to design your own input screen, 
using sedit. You can drag the dotted field 
area down to cover two lines, in the fields 
that require more space. You will then 
need to include appropriate ‘sload’ and 
‘screen’ commands to ensure your Cus- 
tom screen is available. 


Selection 


When you come to make a print- 
out, you need to decide whether you want 
all of the entries, or just some of them. If 
the former, you should first enter the in- 
struction: 


IncludeAll 


which will mark all the records as being 
required. If not, you should enter: 


Identify 


This steps through all the records in turn, 

asking if they are to be included. An an- 

swer of ‘Y’ will set the field ‘UseThis’ to 1, 

whereas ‘N’ will set it to 0. Only those set 

to 1 will be included in the printed list. 
The printing instruction itself is 
the command: 


PrintListYou 


are given the option of sending the output 


Logica! nome 
Authors 
Titles 

Year 
Publishers 
Citys 


Spoehr, A. 
1956 


Chicago 
Compt lationg 
Editors 
Journal$ 
Issued 
Commentd 
UseThis 


Thomas, WL. 


to the screen (by entering an ‘S’); to the 
printer (by entering ‘P’); orto an exportfile, 
for which you should supply a filename. 
Such a file could be imported into Quill or 
another word processor for further editing. 
The various margins and underline codes 
are all set differently for each of these 
three output options. To change them you 
simply edit the procedure ‘OutputTo’ be- 
fore calling PrintList. 

The program will underline the 
publication title, which will be different for 
each of the three publication types. By 
sending CHR(16), the printer driver un- 
derline instruction is toggled on and off - 
whereas on the screen, CHR(5) does the 
same job. 


Hand-painted 


Unfortunately, Quill does not 
seem to import the underlining instruc- 
tions, so you would have to go through 
and ‘paint’ them in by hand. If anyone has 
found a way round this, Open Channel 
would just love to hear from you. 

Finally it may be useful to look 
briefly at the text formatting procedure 
‘Printline’ shown in the listings. It is a 
recurrent problem when printing from Ar- 
chive, that lines may need wrapping 
around, or otherwise chopping up over 
several lines. The procedures OutputTo, 
Printlnit, and PrintLine are all required 
for this, and could be used in any Archive 
application. 

PrintLine uses global variables 
to keep track of required margins, and 
current position on the line. This means 
you can keep sending as many pieces of 
text to PrintLine as you like, and it will 
continue adding to the line it started previ- 
ously, and wrap around correctly at the 
end of the line. It will only start a new 
paragraph when you re-initialise the posi- 


Cultural Differences in Natural Resource Uses 


Man's Role in changing the face of the earth 


tion variables, and Iprint one or more 
blank lines. 


Apologies 


As | said earlier, it is a tortuous 
and more-or-less unreadable bit of pro- 
gramming, for which | apologise. Its con- 
volutions are due to the number of excep- 
tions it has to catch. The best that can be 
said about it is that it works, which ulti- 
mately is what matters. 

The way to use it is as follows. 
Before printing can commence you should 
call OutputTo, to set the margin and un- 
derline variables. This will also redirect 
output to the chosen device. Before each 
paragraph you should call Printinit, to 
initialise the current margins and position. 
From then on, you can keep calling 
PrintLine with as many text items as you 
require. After the first wrap-around the 
‘WrapMargin’ value will be used for the left 
hand side. If you set the variable ‘Under- 
lining’ to 1, text will be underlined until the 
end of the paragraph, or until you reset it 
to 0. 

At the end of the paragraph, you 
must, in addition to calling Printinit, send 
at least one Iprint, to move on to the next 
line. If you want a gap between para- 
graphs, further Iprints are necessary. 

By allowing any number of sepa- 
rate PrintLine calls within a paragraph, 
there is no limit on paragraph size. If you 
gather all the text into one variable before 
formatting it, you are stuck with Archive’s 
255-character limit. The approach used 
here makes a more complicated program, 
but allows formuch more flexible database 
presentation. 

Ifyou have any Archive problems 
you would like to see solved on these 
pages, please write and tell me about 
them, care of Sinclair QL World. 
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MACHINE CODE 


Sy 


o far in this series, | have only 
considered the subject of 
machine code programming 
in terms of writing complete 
multi-tasking programs, en 

tirely in machine code. All the 
examples given have been of this type. 
There are many advantages to this type of 
programming. The code is about as fast 
and compact as you can make it, and the 
most flexible. If it is possible to do some- 
thing on your QL then it must be possible to 
do it with machine code. Most other pro- 
gramming languages will impose some 
constraints. Even if they theoretically allow 
something, often the practical limitations of 
speed and size of program make it unwork- 
able. 

The big disadvantage is that the assem- 
bler language we use to produce machine 
code is by no means easy. This whole 
series has been about trying to make it 
easier, and | hope | have shown that with a 
bit of effort it is possible to put together 
useful programs without getting completely 
bogged down in the minute details of the 
language, provided we start from chunks 
of code which do recognisable jobs, rather 
than the single program lines which make 
up the language. But even doing things this 
way, it is still a very daunting prospect to 
write a major program entirely in machine 
code. 


Own library 


| have quite a library of small machine 
code programs | have produced for my 
own use. Some are very useful; others are 
interesting rather than useful. Most are 
what | would describe as experimental, in 
other words, just trying out ideas. But | 
have to confess that | have never produced 
a large program entirely in machine code, 
and perhaps | never shall. 
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Machine Code . 


Programming 


In the last in the current series, Alan Bridewell explains 
how to combine machine code routines with SuperBasic 
programming for greater efficiency 


Whenever | try a major project, | fall back 
to one of the high-level languages, usually 
either Forth, or SuperBasic, which | then 
compile. The reason is simple enough. 
These languages are so much easier to 
follow and program. This, of course, is the 
reason they were invented. 

You may be getting the impression that 
| am trying to tell you that when it comes to 
major projects, machine code is alright for 
the whiz-kids writing for the leading soft- 
ware houses, but not for mere mortals. 
Well, that’s not what | am saying. For a 
start, if you have a talent for programming 
(and you're twenty years younger than 
me!) then you ought to have a go. You 
never know what you can do until you try. 


The message 


However, the real message is this: you 
do not have to write complete programs in 
machine code. You can write short rou- 
tines which can then be incorporated into 
larger programs written in other languages. 
This can make the program faster and 
more concise than if it had been written 
entirely in a high level language. It can also 
make the language more flexible, and en- 
able you to do things you may not have 
been able to do if you had stuck purely to 
the high level language. 

For most people, the only high level 
language they will be familiar with on the 
QL is SuperBasic. So for the rest of this 
article | shall confine myself to using ma- 
chine code with SuperBasic. There are two 
ways of incorporating your machine code 
into SuperBasic. 

A machine code routine may be loaded 
into the QL ram by first allocating some ram 
space for it using the Respr function, and 
then loading it into the space using the 
Lbytes command. For example, suppose 
you wished to load a routine called Fred 
from a disk in flp1_, and suppose “FRED is 


500 bytes long. Then we could start our 
SuperBasic program with the line: 


z= RESPR(500): LBYTES flp1_FRED,z 


and the routine would load into ram, 
starting at address z. If at some later part of 
the program, we use the line 


CALL z 


the program will start to execute the 
machine code routine from z. When the 
machine code has completed, it will return 
to the next line in the SuperBasic program, 
as long as the machine code ends with the 
two lines: 


MOVEQ #0,D0 ; RETURN NO ERROR 
CODE 
RTS 
TINE 


; RETURN FROM SUBROU 


Without the first of these lines, the ma- 
chine code will return with an error message 
and stop the SuperBasic program. Without 
the last one the routine will not return to 
SuperBasic, and the QL will probably crash! 

Thereis a further important feature of the 
Call command in SuperBasic. It can take 
up to 13 additional parameters, which will 
load in order into the data registers D1 to 
D7, and then the address registers AO to 
AS before. executing the machine code. 
This means that the same machine code 
routine can be made to do different jobs in 
different parts of the SuperBasic program, 
by starting with different parameters. This 
can Clearly lead to a great deal of flexibility 
in use. 

There is, as always, a down side to all 
this. Up to this point in the series, | have 
paid little attention to error trapping. Error 
trapping means that if some data goes into 
the program so that it cannot execute 
properly, it does not crash, but comes up 


with an error message, and still leaves us 
(or the program) in control. The reason | 
have been able to ignore it is because if 
all the data comes from within the code, 
there should be no errors unless there is 
a mistake in the code. The only occasion 
in the series where this was not the case 
was the file transfer routine in part 2. In 
that program, the user had to key in de- 
vice names for input and output channels. 
Without error trapping, any typing errors 
there would have crashed the program. 


Outside errors 


Clearly, if the SuperBasic program 
can change parameters used by our 
machine code, there is room for errors 
to arise from outside the machine code. 
So we must carefully trap them to make 
sure they do not crash the QL. In most 
cases, this is a very simple process. 
The majority of Qdos trap calls and 
vectored routines leave a zero in 
register DO if there is no error, and 
leaves a negative number if there is 
an error. The value of the negative 
number indicates the type of error. So 
after the call is completed we use the 
lines:- 


TST.LDO ;ISDOZERO? 

BNE ERR_Close ; IF NEGATIVE, 
BRANCH TO 

‘Close WITH ERROR CODE 


lf there is no error, the second line is 
ignored. But if there is an error, the second 
line will branch to the short routine to leave 
the machine code with an error message 


.ERR._Close MOVE.W #$CA,A2 ; 
UT_ERRO in A2 
JSR (A2) 


This causes an error message to print in 
channel 0, depending on the number in DO. 

If you have some other code (not a Qdos 
call) which might get an error, you will have 
to devise your own test for the error (usu- 
ally by comparing some data with result 
obtained), then if an error is detected, put 
a suitable negative number in DO before 
branching to ERR_Close. This can be tricky, 
and there are no general rules for it. A 
simple example of this appears in one of 
the listings. 

The other way of incorporating your 
machine code into a SuperBasic program 
is to make the machine code routine a 
SuperBasic procedure or function. This 
means that when you Lbytes and Call the 
routine (with no extra parameters) the 
routine has a name which is added to the 
list of SuperBasic words. The machine 
code needs to calla short routine to add the 
procedure or function name to the 
SuperBasic list, and also to point to the 
code to be used when the name is used in 
SuperBasic. 


Listing 1 


EE EEE EE EK EEE EE EE EEE EEE EER ER EEE EOE 
*“CALLCHANNEL ID~ 
HEE EE HEE EEE HERE REE EEE EEE EE I EE 
THIS ROUTINE WILL TAKE THE FIRST PARAMETER OF THE CALL, WHICH GOES INTO 
REGISTER D1, AND CONVERTS IT TO A BASIC CHANNEL ID IN AO. 
IT SHOULD BE THE FIRST PART OF THE CALL CODE. 
AS IT IS THE START GF A ROUTINE WHICH WILL CORRUPT REGISTERS, THE FIRST 
LINE IS TO STORE REGISTERS. THESE REGISTERS SHOULD BE RESTORED BEFORE 
RETURNING TO BASIC. 
«» START MOVEM.L AO-A7/Di-D7,-(A7) 5; STORE REGISTERS 
MOVEQ #28 ,DO #CH_LENCH IN DO 
MULU Di ,DO MULTIPLY CH. NO, BY ENTRY LENGTH 
MOVE.L $350(A5),A2 3 BYV_CHBAS IN AZ 
ADDA.L DO,AZ 3 ADD TO GET CHANNEL ID ADDRESS 
MOVE.L O(A6,A2.L),AO 5; CHANNEL ID IN AO 


3 
: 


: 
5 
fo FERRE EEREEEEE EEE EERE EERE ER ERE EEE HEEEEEEREEEEE EEE EEEE EEE EE EE EE 


Listing 2 


EE EE EEE HE TE HEHE HE HE TE HE HE SE SE FETE HE FE HE SESE HE TEE IE TE IE IE HE HH EE FEE I FE TE ETE EE IE EH 
"DEFPROC* 
EEE EEE EEE EEE EEE EE EEE EEE EEE EEE EEE EEE EERE EER HEHEHE EEE EEE EE ERE 
THIS ROUTINE WILL ADD A LIST OF PROCEDURES AND FUNCTIONS TO THE 
SUPERBASIC LIST 
MOVE. W $110,A2 5 BP_INIT IN AZ 
LEA PROC_DEF,A1 ; BASIC PROCEDURE DEFINITIONS 
IMP (a2) ; 


NEXT IS THE PROCEDURE & FUNCTION DEFINITION TABLE. ADJUST TO SUIT. 
THE FIRST WORD SHOULD BE THE NUMBER OF PROCEDURES. BUT IF THE NAMES ARE 
LONGER THAN 7 BYTES, IT WILL NEED MORE. 
-PROC_DEF DC.W 2 ; GONE LONG NAME PROCEDURE 
3 THIS IS FOLLWED BY THE NEXT THREE LINES REPEATED FOR EACH PROCEDURE 
DC.wW START-* 5 POINTER TO ROUTINE 
DC.B 8 5 LENGTH OF NAME 
DC.B “ELLIPSES’ ; PROCEDURE NAME 
THEN A 0 TO INDICATE THE END OF THE PROCEDURES 
DC.W a 3 END OF PROCEDURES 
THIS IS FOLLOWED BY EXACTLY THE SAME PATTERN FOR FUNCTIONS 
DC.W ce] 3 NO FUNCTIONS 
DC.W 0 3 END OF DEFINITIONS 


5 
FREE EEE EEE EEE RE LHL EE HE EET EEE EE EEE IEE HEHE IE IE FE EE TEE TEE EE EH 


Listing 3 


Fill cheiiatiahaiahoheiahehaiehalahahehaheheiehehahaisbadsheheheheiehsieheishehehehahehahahubshahihehahehehahehehelahehahahoketshokshokontehcestck 
*“PROCCHANNEL ID‘ 
st sdiahatiahhahatahahahahahahehahahehahehehahahahatehelehehakehsiehaheehshehshehehahahehahahahehahshahohahehakshehahaieketehenstetedokceat 
THIS ROUTINE WILL TAKE THE ONE PARAMETER OF A PROCEDURE AND TURN IT 
INTO A BASIC CHANNEL ID IN AO 
IT SHOULD COME AT THE START OF THE PROCEDURE, AFTER STORING REGISTERS. 


MOVE. W $115,A2 3 CA_GTLIN IN AZ 
JSR (A2) 
MOVEQ #-15,D0 3 ERR_BP IN DO 
CMPI.W #1,D3 3 ONE PARAMETER ? 
BNE ERR_CLOSE ; IF NOT, CLOSE 
MOVE. L O(A6,A1.L),DO ; PARAMETER IN DO 
MOVEQ #$28,D1  ¢ CH_LENCH IN Di 
MULU D1,DO 
MOVE. L $30(A6),AZ } BV_CHBAS IN AZ 
ADDA.L DO,AZ 
MOVE. L O(A6,AZ.L) ,AO ; CHANNNEL ID IN AO 
: HEM He Hee He HE HE HE HE HE HE HE HE HE EE EE HE EE EE EE EE EE EE HE HEE EEE EE HEHE EEE EE 


Listing 4 


3 BEEBE EEE EEE EEE EEE EEE EERE HEHE EEEEE EEE EEE EEE EEE EEE EEE EE EE EERE REE EE 
: "ERR_CLOSE‘ 

i HH EEE EH EEE EEE EEE EEE EEE LEE EE REE EEE RE EEE EEEER EE EERE EERE EERE EEE EEE 
} WHEN AN ERROR HAS BEEN DETECTED, AND THE ERROR CODE IS IN DO, A BRANCH 

; TO THIS CODE WILL PRINT AN ERROR MESSAGE IN BASIC CHANNEL #0 

; THIS CODE SHOULD BE FOLLOWED BY WHATEVER CODE IS NEEDED TO MAKE A SAFE 

; RETURN TO BASIC. 

3 . 
. MOVE.W SCA, AZ ; UT_ERRO IN AZ 

JSR (A2) 


ERR_CLOSE 


5 
§ PERE SE EAE MERE IE HE HE HEM HEHEHE EEE EEE EERE ER HEE HEH EEE HEE ER EE EEE EE EEE EEE 
Listing 5 


F Milli stishahiaiiadioticheiiahaiaiahshahehidahahehahadaduhahelahaiahahekaiahehehsiahshahehadatuhahehahedatshelahededslatahelatedsdetatedotototet td 
' ELLIPSES CALL CODE‘ 
III III IEEE 

3 "CALLCHANNEL ID‘ 

3 

« START MOVEM.L AO-A7/D1-D7,-(A7) 3; STORE REGISTERS 

MOVEG #$28,D0 5 #CH_LENCH IN DO 

MULU D1,DO 5 MULTIPLY CH. NO. BY ENTRY LENGTH 
MOVE.L $30(A6),AZ2 5 BY_CHBAS IN A2 
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Adding routines 


More about this later. This is what Toolkits 
usually do, and Simon Goodwin's excel- 
lent DIY Toolkitseries shows lots of exam- 
ples of this approach to adding machine 
code routines to SuperBasic. | have no 
wish to duplicate his efforts, and | suggest 
you refer to his articles to discover more. | 
would simply add the point that you do not 
have to stick to Toolkit routines, that is, 
ones that might have a variety of uses in 
different programs. You can use the same 
technique for machine code written specifi- 
cally to go into one particular program for 
one particular purpose. 

To illustrate how all this works, | am 
going to use the Ellipse program put to- 
gether in part 8 of this series. | think it will 
be informative to see the same basic rou- 
tine as both a free standing program, and 
as part of a larger program. There are a 
number of modifications that need to be 
made, both to make it work as a subrou- 
tine, and to make it more flexible. 

1. Since it is not to be a free standing 
program, it does not need Jobstart or 
Endjob, so these are removed. However, 
the routine will need to end with the two 
lines mentioned earlier, so that it returns to 
SuperBasic successfully. 

2. As part of a SuperBasic program, it 
would be better to use SuperBasic console 
channels, and enter the channel number 
as a CALL parameter (or as a procedure 
parameter, if you have done it that way). 
This means it does not need Console and 
Close to open and close a console window, 
so these are removed. There is also no 
need to activate a cursorin the SuperBasic 
console windows, so we remove Cursor. 

3. As we are not going to close the 
console window, we need to restore it toa 
normal print mode from the XOR mode 
used in the Ellipse routine, so we need to 
add a Writemode at the end of the routine 
to restore the normal print ink colour onto 
paper colour mode. 


Error trapping 


4, We need to include some appropriate 
error trapping. In this case, the main source 
of any error will be the channel number 
entered as a parameter. The number used 
has to be that of a channel which has been 
opened, obviously. Also, the Fbyte sub- 
routine requires this to be acon_ channel. 
In the case of the code being used as a 
SuperBasic procedure, we must also check 
that only one parameter is used. (Actually, 
we could ignore the extra parameters if 
more than one is entered, but it is good 
form to check anyway.) 

5. We need some code to turn our pa- 
rameter into the channel ID needed in 
register AO. Also, in the case of the 
SuperBasic procedure, we need some 
code to get the parameter from the 
SuperBasic in the first place. Since these 
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two points are the biggest innovations in 
this article, we shall look at them in some 
detail. 

The first important point to remember is 
that just about everything the QL stores 
about its SuperBasicis in an address which 
is stored relative to the address in register 
A6. This is done so that as the demand for 
ram space changes, Qdoscan simply move 
the whole lot to a new set of locations, but 
only has to change the address in A6 to 
enable us to work out the new position of 
everything else. The SuperBasic channel 
{Ds are stored in addresses starting from 
$30 above A6. So we can get the address 
into register A2 with the command: 


ADDA.L 
MOVE .L 


DO ,AZ 


01AS,A2. 


MOVE.L #$30(A6),A2 


Each channel entry is $28 bytes long, 
and they run in sequence from channel #0 
upwards. So if we multiply our channel 
number by $28, and add that to the ad- | 
dress we have put in A2, we get the ad- 
dress of the channel entry for the channel 
we want (relative to A6, of course!) The 
long word at this address is the channel ID. 
So we can put the channel ID in register AO, 
where it is needed for our routines, using 
the line 


MOVE.L 0(A6,A2.L),A0 


3 ADD TO GET CHANNEL ID ADDRESS 
L),AO ; CHANNEL ID IN AO 


YEE TEE HE IIE FEE IEE HEE EE FEE ETE TEE TEE TEESE TIE SE TEE TIE TE TET TE DEAE TEE DETERS FETE TEI TE TEE ETE TE TEE TE TE TE TE FEE 
: THE REST OF THIS IS COMMON TO BOTH THIS PROGRAM AND THE CODE NEEDED 
; TO MAKE ‘ELLIPSES’ A SUPERBASIC PROCEDURE 


MOVED 
MOVE. W 
TRAP 


WMODE #$2C,DO 


#3 


LEA-L 
LEA.L 
MOVEQ 
MOVE. 
DBRA 
BRA.S 


EXA,A2 
#4,D1 


D1 ,LOOP 
FIRST 


3 
«MAIN JSR FBYTE 
: AN INVALID CHANNEL ID WILL GENERATE 


#SFFFF,DI 3 


DEFAULTS, A1 


{ALd+, (AZI+ 


3; #SETMD IN DO 
XOR INK INTO BACKGROUND 


3; DEFAULT PARAMS ADDRESS IN Al 
} ACTUAL PARAMS ADDRESS IN A2 

3 LOOP COUNTER 

; MOVE TWO PARAMETERS 

5 DECREMENT AND LOOP 

5 DRAW DEFAULT ELLIPSE 


} BET KEY PRESS 
AN ERROR HERE TO BE TRAPPED 


; ---- ADD NEXT TWO LINES TO TRAP ERRORS --~- 


TST.L BO 
BNE 
LEA.L 
CMPI.B 
BEQ 
LEA.L 
CMPI.B 
BEQ.S 
JSR 


BYTE,Al 


CLOSE 
BYTE,AL 


copy 

ELLIPSE 
JSR TEST 

- FIRST JSR ELLIPSE 

3 AN INVALID CHANNEL ID WILL GENERATE 


TST. 
BNE 
BRA 


DO 
MAIN 


LEA.L 
MOVER 
MOVE. W 
MOVE. W 
TRAP 

MOVE. B 
RTS 


BYTE ,AlL 
#1,D0 
#0,D1 


3 
»FBYTE 


‘BYTE pc. B o 


#10, (A) 


#32, (AL) 


#$FFFF D3 


; ERROR 7 


ERR_CLOSE 


IN Al 
<ENTER?? 


BYTE ADDRESS 
IS BYTE = 10 
IF SO, CLOSE 
BYTE ADDRESS IN Al 


<SPACE > 


IF SO, NEW ANOTHER ELLIPSE 
TO REMOVE OLD ELLIPSE 
TEST FOR KEY PRESS 
TO DRAW NEW ELLIPSE 
AN ERROR HERE TO BE TRAPPED 
3 ---- ADD NEXT TWO LINES TO TRAPP ERROR ---— 


3 
i 
3 
' 
5 IS BYTE = 32 
5 
5 
3 
; 


3 ERROR? 


ERR_CLOSE 


5 AND START AGAIN 

3; BYTE STORE ADDRESS IN AL 
3 IO_FBYTE IN DO 

3 CLEAR WORD IN Di 

3 INFINITE TIMEOUT 
i 
5 
5 


STORE BYTE 


i 
3 —--— DELETE LINE TO SET ADDRESS OF RI STACK --=~ 


-ELLIPSE 


3 
; MAKE ROCGM FOR 1ST INTEGER 

SUBG.L #2,A1 
; PUT FIRST INTEGER ON RI STACK 


MOVE.W 
CONVERT TO F.P. 
MOVEO 
MOVE. W 
JSR 
REPEAT FOR 2ND INTEGER 
SUBQ.L 
MOVE.W 
MOVEG 
JSR 
NOW DIVIDE ONE F.P. 
MOVE: 
JSR 


#9 ,DO 
#11C,A3 
(A3) 


#2,A1 


#8 ,DO 
(a3) 


##10,D0 
(AS) 


EXA,0(AG,A1-L? 3 


3 #RI_FLOAT ON DO 
3 RI_LEXEC ON AS 
3 


5 
EXB,O(AS,AL.L) ; 


i 
NUMBER BY THE OTHER TO LEAVE K COORD ON RI STACK. 


3 #RI_DIV ON DO 


= 


NOW REPEAT THE WHOLE THING FOR THE Y COORDINATE 


MAKE ROOM FOR 1ST INTEGER 
SUBQ.L #2 ,A1 
PUT FIRST INTEGER ON RI STACK 
MOVE .W 
CONVERT TO F-.P. 


EY4,0(A6,A1-L) 3 


If this all sounds too much to handle, 
don'tworry. Listing two is a short routine 
to do this for you. If you Call your routine 
from SuperBasic with the channel number 
as the one parameter after the address, 
this routine at the start of your code will 
put the channel ID in AO for you. The only 
part of this not already mentioned is the 
first line. Since your routine will alter the 
registers, they must first be saved on the 
stack (except DO, of course). Clearly, at 
the end of your routine, you must restore 
the registers before returning to 
SuperBasic. 


To SuperBasic 


Listing 2 is how you add your routine 
to the SuperBasic list of procedures and 
functions. It follows a very simple format, 
which should cause no problems, once 
you have tried it a few times. It starts with 
the routine itself, which is to load the 
address of the vectored routine BP_INIT 
into A2. The address of the definitions 
table is loaded into A1, and then there is 
a jump to the vectored routine. 

The definition table itself follows a fixed 
format, as follows: 

We start with a word for the number of 
procedures to be added. This word allo- 
cates space in the procedures table, but 
if the average name length is more than 
seven, then more space is needed. With 
one eight-character name, | have made 
this word equal to 2. Then for each pro- 
cedure to be added, this word is followed 
by a word for the address of the routine, 
a byte for the length of the procedure 
name, and a byte string for the name 
itself. A zero word then indicates the end 
of the procedures. Exactly the same 
pattern follows for the functions. In our 
case, we have no functions to add, so we 
have a zero word for the number of 
functions and a zero word for the end of 
the functions. This pattern is very simple 
to modify to add any number of proce- 
dures and functions to SuperBasic. 


Channel ID 


Listing three is the routine to convert 
the SuperBasic channel number, passed 
with the procedure, into a channel ID in 
AO. It starts with a jump to the vectored 
routine CA_GTLIN, which will fetch an 
indeterminate number of long word argu- 
ments passed when a procedure is called 
from SuperBasic. These long words are 
stacked up on the arithmetic stack, and 
the number of long words passed is re- 
turned as the word in D3. 

At this point we put in our DIY error 
trapping for the number of parameters. 
We put -15 in DO, and if it is still there 
when we return from the procedure, it will 
generate a bad parameter message in 
channel 0, and cause the SuperBasic 
program to stop. We then compare D3 
with 1, and if it is not 1 we branch to the 


#8 ,DO ; #RI_FLOAT ON DO 
(A3) : 
#2,A1 
EYB,0(AS,A1.L) 5 
#8,D0 ; 
(a3) 3 
NOW DIVEDE ONE F.P. NUMBER BY THE OTHER TO LEAVE Y COORD ON RI STACK. 
MOVED ##10,D0 4; #RI_DIV ON DO 
JSR (AS) ; 


NOW REPEAT THE WHOLE THING FOR THE ECCENTRICITY 
MAKE ROOM FOR iST INTEGER 
SUBD. L #2,A1 : 
PUT FIRST INTEGER ON RI STACK 
MOVE. W ECCA,O(AG,AL.L? 3 
CONVERT TO F.P. 
MOVEG #9 ,D0 : #RI_FLOAT ON DO 
JSR (A3) : 
REPEAT FOR 2ND INTEGER 
SUBG.L #2,A1 : 
MOVE. W ECCB,O{(AS,A1.L) 3; 
MOVER #8,D0 3 
JSR (3) 3 
NOW DIVIDE ONE F.P. NUMBER BY THE OTHER TO LEAVE ECCEN. ON RI STACK. 
MDVEQ ##10,DO0 5 #RI_DIV ON DO 
JSR (AS) : 


NOW REPEAT THE WHOLE THING FOR THE RADIUS 
MAKE RDOM FOR 1ST INTEGER 

SUBQ.L #2,A4 3 
PUT FIRST INTEGER ON RI STACK 

MOVE. W RADA, O(AG,AL.L) 5 


CONVERT TO F.P. 
MOVES 
JSR 

REPEAT FOR 2ND INTEGER 
SUBQ.L 
MOVE. W 
MOVE 
JSR 


#8,D0 } #RI_LFLOAT ON DO 
(3) ; 


#2,A1 : 
RADB,O(AG,A1.L) 3 
#8,D0 Fy 

(AS) 


3 
NOW DIVIDE ONE F.P. NUMBER BY THE OTHER TO LEAVE RADIUS ON RI STACK. 


MOVEG 
JSR 


#$10,D0 3 #RI_DIV ON DO 
(3) 


NOW REPEAT THE WHOLE THING FOR THE ANGLE OF ROTATION 


MAKE ROOM FOR iST INTEGER 


SUBQ.L 


#2,A1 3 


PUT FIRST INTEGER ON RI STACK 


MOVE . Ww 
CONVERT TO F.P. 
MOVE® 
JSR 
REPEAT FOR 2ND INTEGER 
SUBQ.L 
MOVE.W 
MOVEQ 
JSR 


ROTA,O(AG,AL.L) ¢ 


#8, DO } #RI_FLOAT ON DO 
(AS) ; 


#2,A1 Fy 
ROTB,O(AS,A1.L) 3 
#8 ,DO r] 

(AS) 


5 
NOW DIVIDE ONE F.P. NUMBER BY THE OTHER TO LEAVE ROTATION ON RI STACK. 


MOVER 
JSR 


NOW PLOT THE ELLIPSE 


i 

} INTEGER TABLE 
-EXA 
«EXB 
-EYA 
-EYB 
-ECCA 
-ECCB 
~RADA 
»RADB 
«ROTA 
+ROTB 


5 
» DEFAULTS 


: sree 
EECLETETEEE 


SSSS8SS858 


##10,D0 WRI_DIV GN DO 
(AS) 


#$33,D0 #SD.ELIPS ON DO 
A6,A1 MAKE Al STACK ABSOLUTE 
#3 


80 INTEGER 
1 INTEGER 
30 INTEGER 
i INTEGER 
10 INTEGER ECCENTRICITY 
10 INTEGER ECCENTRICITY 
20 INTEGER RADIUS 

1 INTEGER RADIUS 

Bi INTEGER ROTATION 

10 INTEGER ROTATION 


CENTRE X 
CENTRE X 
CENTRE Y 
CENTRE Y 


80 
1 


3 INTEGER DF CENTRE X 

3 INTEGER CENTRE X 

So 3 INTEGER CENTRE Y¥ 

1 3 INTEGER CENTRE Y 

10 5 INTEGER ECCENTRICITY 
19 i INTEGER ECCENTRICITY 
20 ' INTEGER RADIUS 

1 H INTEGER RADIUS 

31 3 INTEGER ROTATION 

10 3 INTEGER ROTATION 


BYTE,A1 3 BYTE ADDRESS IN Al 
#210,{A1) 3 IS BYTE = <CTRL><UP> 7? 
UPFP 3 IF SO, THEN UP 

BYTE,AL 5 BYTE ADDRESS IN Al 
#2198,(A1) 3; IS BYTE = <CTRL><DOWN> ? 


ERR_Close routine, which means the 
program will stop with an error message. BEQ.S DOWNFP IF SO THEN DOWN 

If there is no error, we move the param- vas ashanti ae AN ae Oe Pee 
eter to DO. Remember that A1 points to LEA.L RADA, AL RADA ADDRESS IN Al 


P = LEA.L RADB ,A2 RADB ADDRESS IN A2 
the stack, relative to A6, so to do this we MOUE. (AL) DO RADA IN DO 


need the line CMPI.W #100,D0 RADA ALREADY 100 7 
BEQ NEXTBIT IF SO LEAVE UNCHANGED 


ADDI.W #1, (AL) ADD 1 TO RADA 

MOVE.L O(A6,A1.1),D0 MOVE ..W (A1) ,DO RADA TO DO 

CMPI.W #100,D0 I8 RADA =100 7? 

The rest of this is to turn the parameter Listing 6 
into a channel ID, and is the same as 
Listing one. 

Listing four is very short and simple. It is 
the routine which is branched to when an 
error is detected, and if there is an error code eae is cube ona 
: Scchict ; : 3 BP_ 
in DO, it will print the error message in channel PROC DEF,Ai ; BASIC PROCEDURE DEFINITIONS 
0. This code should be followed by whatever (a2) 3 
isneededtomakea safe retum to SuperBasic. : ee ; «panes ae saiecenies 
This normally means returning registers to START-* POINTER TO ROUTINE 
their previous state, and possibly alsomaking ites —s OF NAME 

: : : ' DURE NAME 
sure the write mode for any windows is back ; END DF PROCEDURES 


to normal. ; NO FUNCTIONS 
; END OF DEFINITIONS 


FE IEICE IEEE EEE TET TEE IEE IIT FETT TEI ETT TIE ETE 
"ELLIPSES PROCEDURE CODE‘ 


5 
5 
FERRELL EERE EEE EERE EEE EEE EEE EE RR EEE EEE 
3 THIS CODE MUST BE PLACED IN FRONT OF THE COMMON CODE FROM LISTING 5S 

3 TO MAKE THE NAME ‘ELLIPSES’ INTO A SUPERBASIC PROCEDURE 

: 


Application * START 


3 ---- ADD NEXT LINE TO STORE REGISTERS —-~~ 


F ‘ D1i-D7/A0-A7,-{(A7) 3; STORE REGISTERS 
We are now going to apply all this to $118,A2  ; CA.BTLIN IN a2 


: making our Ellipses program into a rou- (A2) 

tine to use in a SuperBasic program, first #-£5,00, 7 ERR_BP’ IN DO 
: #1,D3 3; ONE PARAMETER ? 

| as a piece of Call code, and then as a ERR CLOSE ; IF NOT, CLOSE 
SuperBasic procedure. In both cases, the MOVE. L 0(AS,A1.L),DO ; PARAMETER IN DO 
major part of the listing will be the same. aE! na. 
Only the front end of the code will be MOVE. L $30(A6),A2 ; BV_CHBAS IN AZ 
different in the two cases. In order not to ADDA. L DO,A2 


eRe . »~L),AO ; CHANNNE! IN AO 
repeat large amounts of listing, | have put ; re ¢ Senay eo ae 


in the complete listing for the Call routine RAHI HIE IIIT EEE IIIT RTI DET IAT TAI AD DADA III I 
as Listing five , and the modification 


A i LEA.L ECCA,AL INTEGER ADDRESS IN Al 
needed to make Ellipse a SuperBasic ADDI.W #1, (A1) ADD i Ft; INTEBER 


procedure as Listing six. If you have been BRA NEXTBIT SKIP DOWN 


i j i LEA.L ECCA,AIL INTEGER ADDRESS IN Al 
following this senate and have already SUBI.W #1, (AL) SUBTRACT 1 FROM INTEGER 
typed in the program in part 8, youcan use BRA NEXTBIT . 


that as a starter for Listing five, and make 


3 
7 i i » UPDOWN4S LEA.L BYTE,AL BYTE ADDRESS IN Ali 
the appropriate alterations. The following CMPI.B #21 1, (AL) IS BYTE = <ALTO<KCTRLOCUP> ? 


assumes that is what you will be doing. BEQ.S UP4 IF 80, THEN UP 
Thecammon cade stars with WMODE, mein. Ege th Sa avec wera Seanas 

and anything before that can be deleted. pED.o DOWN4 IF SO, THEN DOWN 

In the .MAIN routine, Fbyte will generate BRA NEXTBIT IF NEITHER, SKIP TO NEXT BIT 

an error if the channel is not open, or if it Sana ei. thas page ag gr narnia Al 

is not a con_ channel, so this error must BRA NEXTBIT SKIP DOWN 

be trapped. Similarly, Ellipse may generate + DOWN4 LEA.L ROTA, AL INTEGER ADDRESS IN Ai 

an error to be trapped. Right at the end of SUBL.W #1, (A1) SUBTRACT 1 FROM INTEGER 

the code we must add the ERR_Close »NEXTBIT RTS 

routine to print any lige bieepee, for : ---+ ADD THE FOLLOWING LINES TO CLOSE ROUTINE AND RETURN TO BASIC —--~ 

trapped errors, and .Close will restore the /ERR_CLOSE MOVE.W $CA, AZ } UT_ERRO IN A2 

window used to normal print mode, and JSR (a2) 

restore the registers. At the front of all this ene EACH 86.01 | oneal. Pavey (one 

is merged Listing 1, which will store the TRAP aa ; 

registers, and turn the parameter of the ie {(A7)+,D1-D7/AO-A7 3 RESTORE REGISTERS 

Call into a channel ID. And that’s it. ’ ' 


| To make Ellipse a SuperBasic proce- ; FER ISHII REET I HIN RENEE gi ea EE ERE IE eT HE Hee 
dure, we simply merge Listing six at the BNE NEXTBIT IF NOT, NEXT BIT 
front instead of Listing one. This is es- pong nig »DO RADB TO DO 
z F . oat 7 DO 18 RADB = 1 ? 
sentially a combination of Listings two MEST RET THEN LEAVE RADA,RADB UNCHANGED 
and three to add Ellipses to the procedure #10, (AL) ELSE, RADA = 10 
list, and to turn the procedure argument poet ne pagel clas 
into a channel ID. One extra line is added Di, DO RADB/10 
to store the registers. This is to balance DO, (a2) NEW DO VALUE IN RADB 
i i NEXTBIT SKIP TO NEXT BIT 
the restore registers line at the end of 1 MAKE NUMBER SMALLER. 
Listing five. As | am not too familiar with » DOWNFP LEAL RADA, A1 RADA ADDRESS IN Ai 
the inner workings of SuperBasic, | am Papa ones RADB ae IN AZ 
not sure this storing and restoring regis- pomig #9 ,DO San a 
ters is actually needed here, because | BEG NEXTBIT ; IF SO, LEAVE UNCHANGED 


suspect that SuperBasic deals with this SUB _ Fink SUE TRACE. 1. EROM RADA 
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already. However, it certainly wont do any 
harm, and anyway, its a good policy to 
make sure that whenever you do anything 
which may corrupt the registers, you al- 
ways store them beforehand and then re- 
store them afterwards. 


Test program 


Listing seven is a short SuperBasic pro- 
gram to test the working of both the Call code 
and the Ellipses procedure. All it does is to 
open a random set of con_ channels number- 
ing 3 to 9, to add to the SuperBasic default 
channels0, 1 and2. Itthen gives you the choice 
of using either the Call code or the Ellipses 
procedure, followed by the choice of which 
channel to draw in. You can then draw circles 
and ellipses all over the screen to your hearts 

| content, noticing that both methods work equally 
well. The SuperBasic itself is straightforward 
and needs no explanation to those of you 
familiar with the language. The only point that 
needs making is that as it stands the program 
expects to find the Call code as flp1_ELLCALL 
and the procedure code as flp1_ELLPROC. 
You may need to alter this to suit you device 
and file names. Also, | have made no attempt 
to Respr exactly the rightamount of ram space 
- 1000 bytes is more than enough. 

Although we have only considered using 
machine code within SuperBasic programs, 
clearly, there is scope for using it with other 
languages. Often, languages like Forth and 
Carenot designed fora particular computer, 
and are therefore unable to take advantage 
of many of the special facilities a machine 
like the QL can offer. This can be overcome 
by using machine code routines. The docu- 
mentation with your language should tell 
you how to do it. However, a word of caution 
is needed. One of the big advantages of 
these languages is that the programs are 
portable, that is, a program written on one 
computer will run on a different computer. If 
you put QL specific machine code routines 
in, this will no longer be true. Your program 
will only runona QL orcompatible machine. 


Conclusion 


This is the end of the series for the present. 
Clearly my little Toolkit is not a complete list of 
allthe routines thatmightbe useful. Forexample, 
| have not touched the wide area of input and 
output to files in data bases, for the simple 
reason that the programming problems this 
throws up do not particularly interest me. But | 
hope it has managed to persuade some QL 
users, who at present only copy listings, that 
writing machine code is not as formidable as it 
at first seems. If you have followed this series 
through, you should be able to putsome simple 
ideas into practice; in which case, please do 
havea go. Remember, new software is the life- 
blood of a machine like the QL. Evenifyoucant 
producing something that can be sold com- 
mercially (lets face it- most of uscan’t), youcan 
always see if QL World will print it, or perhaps 
Quanta or one of the PD libraries would like it. 
Happy coding! 


5 
- UPDOWN2 


3 
. UPDOWNS 


MACHINE CODE 


RADA TO DO 

IS RADA = 9 ? 

IF NOT, NEXT BIT 

RADB TO DO 

IS RADB = 10000 IF DIVIDING 
: THEN LEAVE RADA,RADB UNCHANGED 

ELSE, RADA = 99 

RADB IN DO 

10 IN D4 

RADB*10 

NEW DO VALUE INTO RADB 


MOVE.W 
CMPI.W 
BNE 
MOVE.W 
CMPI.W 
BEQ 
MOVE.W 
MOVE.W 
MOVE .W 
MULU 
MOVE .W 
BRA 


(At) ,DO 
#9,D0 
NEXTBIT 
(AZ) ,DO 
#10000,D0 
NEXTBIT 
#99, (AL) 
(A2) ,DO 
#10,D1 

Di ,DO 

DO, (A2) 
NEXTBIT 
LEA.L BYTE, At 
CMPI.B #208, (AL) 
BEQ.S uP 

LEA.L BYTE, Ai 
CMPI.B #216, (A1) 
BEG.S DOWN 

BRA UPDOWN2 
LEA.L EYA,AL 
ADDI.W #1, (AL?) 
BRA NEXTBIT 
LEA.L EYA,AL 
SUBI.W #1, (AL) 
BRA NEXTBIT 


BYTE ADDRESS IN Ai 
IS BYTE = 208 ? 
IF SO, THEN UP 
; BYTE ADDRESS IN Al 
; IS BYTE = 214 7? 
IF SO THEN DOWN 
IF NEITHER, SKIP TO UPDOWN2 
INTEGER ADDRESS IN Al 
ADD 1 TO INTEGER 
SKIP DOWN 
INTEGER ADDRESS IN AL 
SUBTRACT 1 FROM INTEGER 


BYTE ADDRESS IN Al 

IS BYTE = <RIGHT>? 

IF SO, THEN UP 

BYTE ADDRESS IN Al 

IS BYTE = <LEFT> ? 

IF SO THEN DOWN 

IF NEITHER, SKIP TO UPDOWNS 
INTEGER ADDRESS IN Al 
ADD 1 TO INTEGER 

SKIP DOWN 

INTEGER ADDRESS IN Ai 
SUBTRACT 1 FROM INTEGER 


LEA.L 
CMP1.B 
BEQa.5S 
LEA.L 
CMPI.B 
BEg.S 
BRA.S 
LEA-L 
ADDI.W 
BRA 
LEA.L 
SUBI.W 
BRA 


BYTE, AA 
#200, (Al?) 
uP2 
BYTE,AL 
#192, (AL) 
DOWN2 
UPDOWNS 
EXA,Al 
#1, (AL) 
NEXTBIT 
EXA,AL 
#1, (AL) 
NEXTBIT 


BYTE ADDRESS IN Al 
IS BYTE = <ALT><UP> ? 

IF 80, THEN UP 

BYTE ADDRESS IN Al 

IS BYTE = <ALT><DOWN> ? 

IF SO THEN DOWN 

IF NEITHER, SKIP TO UPDOWN4 


LEA-L 
CMPI.B 
BEG.S 
LEA.L 
CMPI.B 
BEQ.S 
BRA.S 


BYTE,A1L 
#209, (AL) 
UPS 
BYTE,AL 
#217, (AL) 
DOWNS 
UPDOWN4 


Listing 7 


1900 
110 
120 


init 

REPeat loop 

CLS#0 

PRINT#O, “SUPERBASIC PROCEDURE (P), CALL CODE(C) or QUIT(Q) 7" 
at=INKEYS (—1) 

SELect ON at 

= "p" =: proc_code 

= "c" : call_code 

= "q" 

FOR chan = 3 TO 7: CLOSE#chan 

stor 

END SELect 

END REPeat loop 

STOP 

DEFine PROCedure init 

MODE © 

OPEN#3,con_5S12x254a0x 0: CLS#S 

p = RESPR(1000) 

& = RESPR‘(1000) 

LBYTES flpi_eliproc,p 

CALL p 

LBYTES flpi_ellcall,c 

FOR chan=3 TO 7 

x = RND(100 TO 512) 

y = RND(100 TO 200) 

xo = RND(O TO Si2-x} 

yo = RND(G TO 200-y) 

OPEN#chan, "con _"&xk"x "yk" a" xok"x "kyo 

INK#chan,RND(2 TG 7):BORDER#chan,2,RND{(2 TO 7):OVER#chan,-1 
END FOR chan 

END DEFine 

DEFine PROCedure proc_code 

CLS#0: select _chan: prompts: ELLIPSES#ch 

END DEFine 

DEFine PROCedure call_code 

CLS#0: select _chantpromptsrCALL c,ch 

END DEFine 

DEFine PROCedure select_chan 

cLS#o 

PRINT#O, "WHICH CHANNEL (G to 7) 7 " 

REPeat keypress 

at = INKEY#(-1) } 
SELect ON at 

=o TO 7 

ch = af: EXIT keypress 

END SELect 

END REPeat keypress 

END DEFine 

DEFine PROCedure prompts 

CLE8o 

PRINT#0,"CURSOR KEYS TO MOVE ELLIPSE AROUND" 
PRINT#O, "“CTRL+UP/DOWN TO CHANGE SIZE, ALT+UP/DOWN TO CHANGE ECCENTRICITY" 
PRINT#O,"ALT+CTRL+UP/DOWN TO ROTATE ELLIPSE" 
PRINT#0,"SPACE TO DRAW ANOTHER ELLIPSE IN THE SAME WINDOW" 
PRINT#O,"ENTER TO RETURN FROM ROUTINE"; 
END DEFine 
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Dilwyn _—_ Jones Computing 


41 Bro Emrys,  Tal-y-Bont, 
Bangor, Gwynedd LL57 3YT U.K. 
Tel: Bangor (0248) 354023 


NEW QL SOFTWARE 
THE MEGA TOOL KIT £25.00 
version on EPROM ..£40.00 


(F 1M 128k) A superb new toolkit of over 200 
SuperBASIC extensions. Ideal for use in BASIC 
programs and in compiled BASIC programs too- 
there is even a runtime version which can be used 
in compiled commercial or public domain programs 
tree of royalty payment! Comprehensive manual 
and large file of demonstration routines! If you buy 


PROGRAMMING DATABASE 
EASYPTR II ; ADDRESS BOOK & LABEL 
Budget EasyPtr 
DISA disassembler .... 

BASIC REPORTER... 
QLIBERATOR 
BUDGET VERSION... 
QLOAD & QREF 


tha EPROM version, you get the disk version too! 


{F 512k} 4 program for making large text banners, 
up to four pages long! Prints sideways, using outline 
fonts for greatly improved quality of printing (banish 
those horrible jagged edges!). Ideal program tor 
making signs for shows, small businesses, adverts, 
and sa on. Currently only suitable for 9 pin Epson 
compatible printers, other versions being written, 


SOLITAIRE 
CRICKET SECRETARY £12.00 


QUESTION MASTER £10.00 
QRACTAL SCREENS .£5.00 QL FLEET TACTICAL 


IMAGE PROCESSOR £15.00 COMMAND II 
Version 1 upgrade .....£10.00 THE FUGITIVE 


PD2 CLIPART COCKTAILS WAITER £10.00 
SCREEN SNATCHERE£10.00 


TEXT 'N'GRAPHIX ....£20.00 
TRANS24 


please enquire! 


(F 384k) A really simple to use menu dnven editor. 
Can be used for editing plain text files, binary files, 
creating source files for asemblers and so on-even 
to edit SuperBASIC programs, in fact any 
application where an easy to use editor is more 
useful than a word processor. Features include full 
block handling, seare h and replace, word wrap, 
margins, can use Toolkit 2 detault device, dynamic 
linked list memory handling, configurable with 


OTHER QL SOFTWARE 
PRINTMASTER .........£20.00 
HOME BUDGET 
REMIND-ME A 
REMIND-ME PLUS ...£20.00 
SCREEN ECONOMISER 


CONFIG, many features! 


OPD TRANSFER ....£15.00 
Sottware to allow the transfer of files between the 
QL and the microdrives on OPD and Tonto 
computers, written by the author of Discover and 


PAGE DESIGNER 2+ £40.00 
NB Delayed-please check if 
available yet before ordering. 
Textidy. UPGRADE PD2 TO PD2 PLUS .... £20.00 
NEW! PC VERSION OF 
FLEET TACTIVAL 
COMMAND II : 
QL+PC versions pack £85.00 
Upgrade-contact us! 


Compatible with the QL version, but with improved 
graphics, Can be networked to a QL version by 
means of a QL to PC seriat lead (wiring diagram 
included). If you enjoyed playing the QL version and 
also have a PC, you can now enjoy playing this on a 
PC as well! 


SLOWGOLD 
TASKMASTER 
DISK LABELLER 


TEXT THE CAT 


BIBLE TEXT DISKS, PLAIN 
TEXT FORMAT 
QUILL_DOC FILES ...£20.00 
SPELLBOUND VISION MIXER 1 


SPELLBOUND S.E..... £50.00 VISION MIXER PLUS £22.50 
Upgrade to SE version £30.00 PICTUREMASTER ....£15.00 


QUICK POSTERS .....£10.00 PICTUREMASTER + .£20.00 
ROB ROY PACK £10.00 


FILE HANDLING HARDWARE 


Z MINI PROCESS 
F 
FILE TRANST Et CONTROLLER .......... £59.95 
MPC TOOLKIT software £9.95 
NETWORK PROVER ..£3.50 


THE SMALL PRINT! POSTAGE AND PACKING CHARGES: Software is sent post-free to UK addresses. To other countries, please add £1.00 per program for postage and packing. 
PRICES: All prices are shown in UK Pounds Sterling. PAYMENT: We can accept payment by cheque (in UK Pounds Sterling currency only, please, drawn on UK branch of a bank or 
building society),Eurocheque, Postal Order, or by these credil cards: VISA, ACCESS, MASTERCARD, EUROCARD and by CONNECT card, Please st ate the card type, number, 
expiry date. your address and sign orders sent by post. We can also accept orders paid by credit card by telephone. There is an answering maching for when | cannot answer in 
person, so that I can call you back later. Goods remain the property of DJC until paid for in full. PLEASE STQATE IF YOU REQUIRE 3.5 OR 5.25 INCH DISKS OF ON 
MICRODRIVE CARTRIDGE (ADD £1 PER PROGRAM ON MICRODAIVE CARTRIDGE TO COVER HIGHER COSTS OF SUPPLYING SOFTWARE ON MICRODRIVE). 


